# 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
