Deep Code Reasoning MCP Server

An MCP server that pairs Claude Code with Google's Gemini AI for complementary code analysis. This server enables a multi-model workflow where Claude Code handles tight terminal integration and multi-file refactoring, while Gemini leverages its massive context window (1M tokens) and code execution capabilities for distributed system debugging and long-trace analysis.

Core Value

Both Claude and Gemini can handle deep semantic reasoning and distributed system bugs. This server enables an intelligent routing strategy where:

• Claude Code excels at local-context operations, incremental patches, and CLI-native workflows
• Gemini 2.5 Pro shines with huge-context sweeps, synthetic test execution, and analyzing failures that span logs + traces + code

The "escalation" model treats LLMs like heterogeneous microservices - route to the one that's most capable for each sub-task.

Features

• Gemini 2.5 Pro Preview: Uses Google's latest Gemini 2.5 Pro Preview (05-06) model with 1M token context window
• Conversational Analysis: NEW! AI-to-AI dialogues between Claude and Gemini for iterative problem-solving
• Execution Flow Tracing: Understands data flow and state transformations, not just function calls
• Cross-System Impact Analysis: Models how changes propagate across service boundaries
• Performance Modeling: Identifies N+1 patterns, memory leaks, and algorithmic bottlenecks
• Hypothesis Testing: Tests theories about code behavior with evidence-based validation
• Long Context Support: Leverages Gemini 2.5 Pro Preview's 1M token context for analyzing large codebases

Prerequisites

• Node.js 18 or later
• A Google Cloud account with Gemini API access
• Gemini API key from Google AI Studio

Key Dependencies

• @google/generative-ai: Google's official SDK for Gemini API integration
• @modelcontextprotocol/sdk: MCP protocol implementation for Claude integration
• zod: Runtime type validation for tool parameters
• dotenv: Environment variable management

Installation

Quick Install for Cursor

Note: After installation, you'll need to update the file path to your actual installation directory and set your GEMINI_API_KEY.

Manual Installation

1. Clone the repository:

git clone https://github.com/Haasonsaas/deep-code-reasoning-mcp.git
cd deep-code-reasoning-mcp

2. Install dependencies:

npm install

3. Set up your Gemini API key:

cp .env.example .env
# Edit .env and add your GEMINI_API_KEY

4. Build the project:

npm run build

Configuration

Environment Variables

• GEMINI_API_KEY (required): Your Google Gemini API key

Claude Desktop Configuration

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "deep-code-reasoning": {
      "command": "node",
      "args": ["/path/to/deep-code-reasoning-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key"
      }
    }
  }
}

How It Works