Gemini CLI MCP Server

A Model Context Protocol (MCP) server that integrates Gemini CLI with Claude Code for comprehensive codebase analysis using code2prompt.

Features

Comprehensive Codebase Review: Full architectural analysis using Gemini's 1M token context window
Targeted Component Analysis: Focused analysis on specific files/folders
Code2Prompt Integration: Efficient codebase context extraction with token optimization
OAuth Support: Works with your existing Gemini CLI OAuth authentication
Claude Code Sub-Agent: Specialized agent for intelligent analysis orchestration

Prerequisites

Required Tools

Node.js 18+ - For running the MCP server
Gemini CLI - Google's CLI tool with OAuth authentication
code2prompt - Rust CLI tool for codebase extraction
Claude Code - For sub-agent integration

Installation Steps

1. Install Gemini CLI

npm install -g @google/gemini-cli

Authenticate with your Google account:

gemini
# Follow OAuth setup prompts

2. Install code2prompt

# macOS/Linux with Homebrew
brew install mufeedvh/tap/code2prompt

# Or build from source
cargo install code2prompt

3. Install MCP Server Dependencies

cd /Users/ryangould/Dev/gemini-cli-mcp
npm install

Setup & Configuration

1. Build the MCP Server

npm run build

2. Configure Claude Code MCP Settings

Add to your Claude Code MCP settings (usually ~/.config/claude-desktop/mcp_settings.json):

{
  "mcpServers": {
    "gemini-cli-mcp": {
      "command": "node",
      "args": [
        "/Users/ryangould/Dev/gemini-cli-mcp/dist/server.js"
      ],
      "env": {}
    }
  }
}

3. Restart Claude Code

Restart Claude Code to load the new MCP server.

Available Tools

`gemini_comprehensive_review`

Performs a complete codebase architectural review using Gemini CLI.

Parameters:

workingDir (string): Path to the codebase directory
excludePatterns (array, optional): Additional patterns to exclude

Usage Example:

// Called by Claude Code sub-agent
gemini_comprehensive_review({
  workingDir: "/path/to/your/project"
})

`gemini_targeted_analysis`

Analyzes specific files or folders with focused insights.

Parameters:

workingDir (string): Path to the codebase directory
targetPaths (array): Specific files/folders to analyze
analysisContext (string, optional): Additional context for the analysis

Usage Example:

// Called by Claude Code sub-agent
gemini_targeted_analysis({
  workingDir: "/path/to/your/project",
  targetPaths: ["src/api/", "src/controllers/auth.js"],
  analysisContext: "Security review of authentication components"
})

Claude Code Integration

Sub-Agent Usage

The gemini-code-analyzer sub-agent is automatically available in Claude Code once the MCP server is configured.

Example Commands:

"Please analyze this entire codebase for architectural issues"
"Review the authentication module in src/auth/ for security vulnerabilities"
"Analyze the API endpoints in src/controllers/ for performance bottlenecks"

Manual Tool Access

You can also call the MCP tools directly through Claude Code's tool interface:

Use /tools to see available MCP tools
Select gemini_comprehensive_review or gemini_targeted_analysis
Provide required parameters

Development

Running in Development Mode

npm run dev

Building for Production

npm run build
npm start

Project Structure

gemini-cli-mcp/
├── src/
│   ├── server.ts              # Main MCP server
│   ├── tools/                 # MCP tool implementations
│   │   ├── comprehensive-review.ts
│   │   └── targeted-analysis.ts
│   └── utils/                 # Utility functions
│       ├── code2prompt-executor.ts
│       └── gemini-executor.ts
├── prompts/                   # Prompt templates
│   ├── comprehensive-review.md
│   └── targeted-analysis.md
├── dist/                      # Built TypeScript output
└── package.json

Troubleshooting

Common Issues

"gemini command not found"

Ensure Gemini CLI is installed and in your PATH:

npm install -g @google/gemini-cli
which gemini

"code2prompt command not found"

Install code2prompt:

cargo install code2prompt
# or
brew install mufeedvh/tap/code2prompt

Authentication Issues

Re-authenticate with Gemini CLI:

gemini
# Follow OAuth prompts again

MCP Server Not Connecting

Check Claude Code MCP settings configuration
Verify the server path is correct
Check console logs for errors
Restart Claude Code after configuration changes

Logging

The MCP server logs to stderr. Monitor logs when running:

npm run dev

Configuration Options

Excluding Files/Patterns

The comprehensive review automatically excludes common patterns:

node_modules/**
.git/**
*.log
dist/**, build/**
.next/**
coverage/**

Add custom exclusions via the excludePatterns parameter.

Token Management

code2prompt provides token counting for large codebases
Gemini CLI handles the 1M token context window automatically
Large codebases are efficiently processed through code2prompt's optimization

Security Considerations

Uses your existing Gemini CLI OAuth authentication
No API keys stored in the MCP server
Codebase content is sent to Gemini for analysis
Consider data sensitivity when analyzing proprietary code

License

MIT License - See LICENSE file for details

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables comprehensive codebase analysis using Google's Gemini AI through CLI integration. Provides architectural reviews and targeted code analysis with code2prompt integration for efficient context extraction.

Related MCP Servers

Second Opinion MCP Server
PoliTwit1984
-
security
F
license
-
quality
Provides AI-powered assistance for coding problems using Google's Gemini AI, combined with Perplexity insights and Stack Overflow references, facilitating contextual analysis and automatic response archiving for improved troubleshooting.
Last updated -
13
Claude Code + Gemini MCP Server
RaiAnsar
-
security
A
license
-
quality
Connects Claude Code with Google's Gemini AI, allowing users to ask Gemini questions, get code reviews, and brainstorm ideas directly within Claude Code.
Last updated -
222
MIT License
Deep Code Reasoning MCP Server
haasonsaas
A
security
A
license
A
quality
Pairs Claude Code with Google's Gemini AI for complementary code analysis, enabling intelligent routing where Claude handles local-context operations while Gemini leverages its 1M token context for distributed system debugging and long-trace analysis.
Last updated -
10
90
MIT License
Gemini CLI Orchestrator MCP
dnnyngyen
A
security
A
license
A
quality
A lightweight MCP server that enables AI agents to perform deep codebase analysis by leveraging Gemini's massive context window for cross-file analysis and intelligent file selection.
Last updated -
4
13
MIT License

View all related MCP servers

Appeared in Searches

AI Model CLI Tools and Orchestration Configuration