my-pal-mcp-server/README.md

Zen MCP: Many Workflows. One Context.

zen_web.webm

🤖 Claude OR Gemini CLI + [Gemini / OpenAI / Grok / OpenRouter / DIAL / Ollama / Any Model] = Your Ultimate AI Development Team

AI orchestration for Claude Code - A Model Context Protocol server that gives Claude access to multiple AI models for enhanced code analysis, problem-solving, and collaborative development.

True AI collaboration with conversation continuity - Claude stays in control but gets perspectives from the best AI for each subtask. Context carries forward seamlessly across tools and models, enabling complex workflows like: code reviews with multiple models → automated planning → implementation → pre-commit validation.

You're in control. Claude orchestrates the AI team, but you decide the workflow. Craft powerful prompts that bring in Gemini, O3, Flash, or local models exactly when needed.

Quick Start (5 minutes)

Prerequisites: Python 3.10+, Git, uv installed

1. Get API Keys (choose one or more):

• OpenRouter - Access multiple models with one API
• Gemini - Google's latest models
• OpenAI - O3, GPT-5 series
• X.AI - Grok models
• DIAL - Vendor-agnostic model access
• Ollama - Local models (free)

2. Install (choose one):

Option A: Instant Setup with uvx (recommended)

// Add to ~/.claude/settings.json or .mcp.json
{
  "mcpServers": {
    "zen": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/BeehiveInnovations/zen-mcp-server.git", "zen-mcp-server"],
      "env": { "GEMINI_API_KEY": "your-key-here" }
    }
  }
}

Option B: Clone and Setup

git clone https://github.com/BeehiveInnovations/zen-mcp-server.git
cd zen-mcp-server
./run-server.sh  # Handles everything: setup, config, API keys

3. Start Using!

"Use zen to analyze this code for security issues with gemini pro"
"Debug this error with o3 and then get flash to suggest optimizations"
"Plan the migration strategy with zen, get consensus from multiple models"

👉 Complete Setup Guide with detailed installation, configuration, and troubleshooting

Core Tools

🤝 Collaboration & Planning

• chat - Brainstorm ideas, get second opinions, validate approaches
• thinkdeep - Extended reasoning, edge case analysis, alternative perspectives
• planner - Break down complex projects into structured, actionable plans
• consensus - Get expert opinions from multiple AI models with stance steering

🔍 Code Analysis & Quality

• analyze - Understand architecture, patterns, dependencies across entire codebases
• codereview - Professional reviews with severity levels and actionable feedback
• debug - Systematic investigation and root cause analysis
• precommit - Validate changes before committing, prevent regressions

⚒️ Development Tools

• refactor - Intelligent code refactoring with decomposition focus
• testgen - Comprehensive test generation with edge cases
• secaudit - Security audits with OWASP Top 10 analysis
• docgen - Generate documentation with complexity analysis

🔧 Utilities

• challenge - Prevent "You're absolutely right!" responses with critical analysis
• tracer - Static analysis prompts for call-flow mapping

👉 Complete Tools Reference with examples, parameters, and workflows

Key Features

🧠 AI Orchestration

• Auto model selection - Claude picks the right AI for each task
• Multi-model workflows - Chain different models in single conversations
• Conversation continuity - Context preserved across tools and models
• Context revival - Continue conversations even after context resets

⚡ Model Support

• Multiple providers - Gemini, OpenAI, X.AI, OpenRouter, DIAL, Ollama
• Latest models - GPT-5, Gemini 2.5 Pro, O3, Grok-4, local Llama
• Thinking modes - Control reasoning depth vs cost
• Vision support - Analyze images, diagrams, screenshots

🛠 Developer Experience

• Guided workflows - Systematic investigation prevents rushed analysis
• Smart file handling - Auto-expand directories, manage token limits
• Web search integration - Access current documentation and best practices
• Large prompt support - Bypass MCP's 25K token limit

Example Workflows

Multi-model Code Review:

"Perform a codereview using gemini pro and o3, then use planner to create a fix strategy"

→ Claude reviews code systematically → Consults Gemini Pro → Gets O3's perspective → Creates unified action plan

Collaborative Debugging:

"Debug this race condition with max thinking mode, then validate the fix with precommit"

→ Deep investigation → Expert analysis → Solution implementation → Pre-commit validation

Architecture Planning:

"Plan our microservices migration, get consensus from pro and o3 on the approach"

→ Structured planning → Multiple expert opinions → Consensus building → Implementation roadmap

👉 Advanced Usage Guide for complex workflows, model configuration, and power-user features

Why Zen MCP?

🎯 Problem: Claude is brilliant but sometimes needs:

• Multiple AI perspectives for complex decisions
• Systematic workflows to prevent rushed analysis
• Extended context beyond its limits
• Access to specialized models (reasoning, speed, local)

✅ Solution: Zen orchestrates AI models as Claude's development team:

• Claude stays in control - You give instructions to Claude
• Models provide expertise - Each AI contributes their strengths
• Context flows seamlessly - Full conversation history across tools
• You decide the workflow - Simple requests or complex orchestration

Quick Links

📖 Documentation

• Getting Started - Complete setup guide
• Tools Reference - All tools with examples
• Advanced Usage - Power user features
• Configuration - Environment variables, restrictions

🔧 Setup & Support

• WSL Setup - Windows users
• Troubleshooting - Common issues
• Contributing - Code standards, PR process

License

Apache 2.0 License - see LICENSE file for details.

Acknowledgments

Built with the power of Multi-Model AI collaboration 🤝

• Actual Intelligence by real Humans
• MCP (Model Context Protocol) by Anthropic
• Claude Code - Your AI coding orchestrator
• Gemini 2.5 Pro & Flash - Extended thinking & fast analysis
• OpenAI O3 & GPT-5 - Strong reasoning & latest capabilities

Star History