claude-code-gemini-mcp

ShunL12324/claude-code-gemini-mcp

3.2

If you are the rightful owner of claude-code-gemini-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Claude Code Gemini MCP is a server that allows Claude Code to interact with Gemini models using an OpenAI-compatible API.

Tools
4
Resources
0
Prompts
0

Claude Code Gemini MCP

MCP Server that enables Claude Code to call Gemini models through OpenAI-compatible API.

Installation

git clone https://github.com/shun-sfoo/claude-code-gemini-mcp.git
cd claude-code-gemini-mcp
npm install
npm run build

Configuration

Environment Variables

VariableDescriptionRequired
GEMINI_API_KEYYour API keyYes
GEMINI_BASE_URLAPI endpoint (OpenAI-compatible)Yes
GEMINI_MODELModel ID (default: gemini-3-pro-preview)No

Claude Code Integration

Add to your project's .mcp.json:

{
  "mcpServers": {
    "gemini": {
      "command": "node",
      "args": ["/path/to/claude-code-gemini-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-api-key",
        "GEMINI_BASE_URL": "https://your-api-endpoint/v1",
        "GEMINI_MODEL": "gemini-3-pro-preview"
      }
    }
  }
}

Or add to global settings (~/.claude/settings.json).

Available Tools

gemini_think

Deep analysis and reasoning for complex problems.

Parameters:

  • problem (string, required) - The problem to analyze
  • context (string, optional) - Background information
  • thinkingStyle (string, optional) - One of: analytical, creative, critical, systematic

gemini_brainstorm

Generate multiple creative ideas with pros and cons.

Parameters:

  • topic (string, required) - The topic to brainstorm
  • constraints (string, optional) - Constraints or requirements
  • count (number, optional) - Number of ideas, 3-10 (default: 5)

gemini_review

Code, architecture, security, or performance review.

Parameters:

  • content (string, required) - Content to review
  • reviewType (string, required) - One of: code, architecture, security, performance
  • focus (string, optional) - Specific aspects to focus on

gemini_query

General purpose query with full control.

Parameters:

  • prompt (string, required) - The prompt to send
  • systemPrompt (string, optional) - System prompt
  • temperature (number, optional) - 0-2 (default: 0.7)

Testing

# Create .env file first
cp .env.example .env
# Edit .env with your credentials

# Run tests
npm test

Development

npm run dev    # Watch mode
npm run build  # Build
npm test       # Run tests

License

MIT