gem-mcp

# Clone the repository
git clone https://github.com/riccardosecchi/gem-mcp.git
cd gem-mcp

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Install Playwright browsers (for visual inspection)
playwright install chromium

# Copy the example env file
cp .env.example .env

# Edit with your API keys
nano .env

# Single Gemini key
GEMINI_API_KEY=your_key_here

# OR multiple keys for rotation (recommended)
GEMINI_API_KEYS=key1,key2,key3,key4

# Groq fallback (optional but recommended)
GROQ_API_KEY=gsk_your_groq_key

# Edit ~/.claude.json

{
  "mcpServers": {
    "gem-mcp": {
      "command": "/path/to/gem-mcp/venv/bin/python3",
      "args": [
        "/path/to/gem-mcp/server.py"
      ]
    }
  }
}

# Start Claude Code
claude

# Inside Claude, check MCP servers
/mcp

Use: "Think through the requirements for building a todo app"

Use: "Create a blueprint for a Flutter expense tracker app"

Use: "Scaffold the project based on the blueprint"

Use: "Write the main.dart file with dependency injection setup"

Use: "Check if the login page matches the design mockup"

Use: "Run pytest and fix any failures"

Use: "Find all usages of the UserRepository class"

┌─────────────────────────────────────────────────────────────┐
│                     Claude Code (LLM)                        │
└───────────────────────────┬─────────────────────────────────┘
                            │ MCP Protocol
                            ▼
┌─────────────────────────────────────────────────────────────┐
│                      gem-mcp Server                          │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │  Architect  │  │ Fabricator  │  │   Visual Engine     │  │
│  │ (Pro Model) │  │(Flash Model)│  │ (Playwright+Flash)  │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
├─────────────────────────────────────────────────────────────┤
│                    Tool Layer (8 Agents)                     │
│  • sequential_thinking    • intelligent_code_writer         │
│  • architect_blueprint    • visual_inspector                │
│  • scaffold_project       • qa_sentinel                     │
│  • search_codebase        • clear_thought_process           │
└─────────────────────────────────────────────────────────────┘

gem-mcp/
├── server.py          # Main MCP server with all tools
├── requirements.txt   # Python dependencies
├── .env.example       # Environment template
├── CLAUDE.md          # Instructions for Claude
└── README.md          # This file