Gemini MCP Server

A Model Context Protocol (MCP) server that integrates Google's Gemini AI with Claude Code for enhanced development workflows.

Overview

This MCP server provides Claude Code with access to Gemini AI capabilities for advanced code analysis, planning, and consultation. It bridges the gap between Claude's development assistance and Gemini's powerful language understanding, offering a comprehensive AI-powered development experience.

Features

Current Tools

Planning & Strategy

• generate-plan - Generate detailed implementation plans for development tasks

• strategic-plan - Create high-level strategic roadmaps for complex features

• review-approach - Review and validate implementation approaches before coding

Analysis & Understanding

• analyze-codebase - Analyze codebase structure and patterns before making changes

• explain-concept - Get comprehensive explanations of technical concepts and patterns

• compare-technologies - Compare different technologies, frameworks, or approaches

Development Support

• gemini-consult - Get expert guidance when stuck on problems or need additional context

• generate-tests - Generate comprehensive test strategies and plans

• generate-docs - Create documentation structure and content strategies

• debug-assist - Analyze errors and get systematic debugging assistance

Claude Commands

Each tool is accessible via Claude Code commands:

Planning & Strategy

• /plan - Generate detailed implementation plans

• /strategy - Create strategic roadmaps for complex features

• /review - Review and validate implementation approaches

Analysis & Understanding

• /analyze - Analyze codebase architecture and patterns

• /explain - Get comprehensive explanations of technical concepts

• /compare - Compare technologies, frameworks, or approaches

Development Support

• /consult - Get expert guidance and development advice

• /tests - Generate comprehensive test strategies

• /docs - Create documentation structure and strategies

• /debug - Get systematic debugging assistance

Prerequisites

• Node.js 18+ and pnpm

• Gemini CLI installed and configured

• Valid Google AI API credentials for Gemini access

• Claude Code CLI

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/gemini-mcp.git cd gemini-mcp

2. Install dependencies:

   pnpm install

3. Build the project:

   pnpm build

4. Configure Gemini CLI with your API credentials:

   gemini auth login

Usage

Running the Server

For development:

For production:

Integration with Claude Code

Add this server to your Claude Code configuration:

Adding custom commands

Copy the content of claude-commands to your .claude/commands folder

Using the Tools

Once configured, you can use the tools directly in Claude Code:

Planning and Strategy

Analysis and Understanding

Development Support

Development

Project Structure

Available Scripts

• pnpm dev - Run in development mode with hot reload

• pnpm build - Compile TypeScript and auto-generate commands

• pnpm generate-commands - Generate claude-commands from tool configurations

• pnpm start - Run the compiled server

• pnpm typecheck - Run TypeScript type checking

• pnpm clean - Remove build artifacts

Adding New Tools

1. Add new prompt template in src/prompts.ts

2. Add tool configuration in src/tools.ts

3. Implement the method in src/gemini.ts

4. Add case in src/server.ts switch statement

5. Run pnpm generate-commands to auto-create documentation

6. Update this README if needed

The system automatically generates claude-commands from tool configurations, ensuring consistency.

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests if applicable

5. Submit a pull request

License

MIT License - see LICENSE file for details