Gemini Planning MCP

MCP server that integrates Google Gemini with Context7 documentation for intelligent project planning in Claude.

Prerequisites

Before installation, make sure you have:

Node.js 18+ - Download
NPM (comes with Node.js)
Claude Code - Download
Gemini CLI - Download

Check your versions:

node --version  # Should be v18 or higher
npm --version   # Should be v8 or higher
claude --version  # Should show Claude CLI version

What it does

When you ask Claude to plan a project, this MCP server:

Fetches relevant documentation from Context7
Uses Gemini to generate detailed implementation plans
Returns structured, actionable project plans

Installation

Step 1: Get Gemini API Key

Get your free API key from: https://makersuite.google.com/app/apikey

Step 2: Create Configuration File

Windows:

(echo GEMINI_API_KEY=your_key_here && echo GEMINI_MODEL=gemini-2.5-pro) > %USERPROFILE%\.env

Mac/Linux:

cat > ~/.env << EOF
GEMINI_API_KEY=your_key_here
GEMINI_MODEL=gemini-2.5-pro
EOF

Step 3: Install and Add to Claude

# Install globally
npm install -g gemini-planning-mcp

# Add to Claude
claude mcp add planning -s user -- gemini-planning

# Verify it's working
claude mcp list

You should see: planning: gemini-planning - ✓ Connected

Usage in Claude

# Test connection
"Test gemini connection"

# Create project
"Create project context for an e-commerce site with React and Node.js"

# Generate plan with documentation
"Generate plan with libraries: [{name: 'next.js'}, {name: 'stripe'}, {name: 'supabase'}]"

# View as checklist
"Render plan checklist"

Example Workflow

Create a project:

Create project context for a SaaS dashboard with authentication and payments

Generate detailed plan:

Generate plan with libraries: [{name: 'next.js'}, {name: 'supabase'}, {name: 'stripe'}]

Get implementation checklist:
```
Render the plan as a checklist
```

Available Tools

test_gemini_connection - Verify Gemini API connection
test_context7_connection - Verify Context7 documentation service
create_project_context - Start a new project planning session
generate_plan_with_gemini - Create detailed plan with library documentation
render_plan_checklist - Display plan as actionable checklist

Troubleshooting

"Failed to connect" error

Check your API key in ~/.env or %USERPROFILE%\.env
Try reinstalling: npm install -g gemini-planning-mcp
Restart Claude after adding the MCP server

Test your setup

# Check if installed
npm list -g gemini-planning-mcp

# Test directly
gemini-planning

Supported Models

gemini-2.5-pro (recommended)
gemini-1.5-pro
gemini-2.0-flash-exp

License

MIT

Detalhes do pacote

gemini-planning-mcp

readme (leia-me)