# Gemini Collaboration MCP Server
[English](#) | [한국어](./README.ko.md)
MCP Server for Claude & Gemini Collaboration. Consult Gemini AI for a second opinion or collaborate on code development together.
## Features
### 1. `consult_gemini` - Get a Second Opinion
Ask Gemini for advice, validation, or a different perspective on your work.
**Use cases:**
- Validate your approach
- Get code reviews
- Ask for expert advice on technical problems
- Get a different perspective on implementation choices
### 2. `collaborate_on_code` - Build Together
Collaborate with Gemini to develop code from scratch through iterative dialogue.
**Process:**
1. Create and review PRD together
2. Decide on tech stack together
3. Generate and refine code together
## Installation
### Via npm (Recommended)
```bash
npm install -g gemini-collaboration-mcp
```
### Via GitHub
```bash
git clone https://github.com/henry2craftman/gemini-collaboration-mcp.git
cd gemini-collaboration-mcp
npm install
npm run build
```
## Configuration
### 1. Get Gemini API Key
Get your API key from [Google AI Studio](https://makersuite.google.com/app/apikey)
### 2. Configure Claude Code
Add to your Claude Code MCP settings:
**For npm installation:**
```json
{
"mcpServers": {
"gemini-collaboration": {
"command": "npx",
"args": ["-y", "gemini-collaboration-mcp"],
"env": {
"GEMINI_API_KEY": "your-gemini-api-key-here"
}
}
}
}
```
**For local installation:**
```json
{
"mcpServers": {
"gemini-collaboration": {
"command": "node",
"args": ["path/to/gemini-collaboration-mcp/dist/mcp-server.js"],
"env": {
"GEMINI_API_KEY": "your-gemini-api-key-here"
}
}
}
}
```
### 3. Restart Claude Code
Restart Claude Code to load the MCP server.
## Usage
Once configured, you can use these commands in Claude Code:
### Consult Gemini
```
"Gemini, what do you think about this approach?"
"Ask Gemini to review this code"
"Get Gemini's opinion on this implementation"
```
### Collaborate on Code
```
"Collaborate with Gemini to build a 3D dice game"
"Work with Gemini to create a calculator app"
"Develop a todo list app together with Gemini"
```
## Architecture
This MCP server uses the [AI Orchestration Framework](https://github.com/henry2craftman/ai-orchestration) to:
- Chain AI model interactions
- Manage context between Claude and Gemini
- Execute multi-step collaborative workflows
## Requirements
- Node.js 18 or higher
- Gemini API key
- Claude Code (Anthropic's official CLI)
## Development
```bash
# Install dependencies
npm install
# Build
npm run build
# Run MCP server directly
npm run mcp
# Run interactive chat
npm run chat
```
## License
MIT
## Contributing
Contributions are welcome! Please open an issue or submit a pull request.
## Support
For issues, questions, or suggestions, please open an issue on GitHub.
