# Claude Code Gemini MCP

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

## Installation

```bash
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

| Variable | Description | Required |
|----------|-------------|----------|
| `GEMINI_API_KEY` | Your API key | Yes |
| `GEMINI_BASE_URL` | API endpoint (OpenAI-compatible) | Yes |
| `GEMINI_MODEL` | Model ID (default: `gemini-3-pro-preview`) | No |

### Claude Code Integration

Add to your project's `.mcp.json`:

```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

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

# Run tests
npm test
```

## Development

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

## License

MIT