Skip to main content
Glama

Zen MCP Server

  • Apple
  • Linux

Zen MCP Server NPX Wrapper

Easy-to-use NPX wrapper for Zen MCP Server - Give Claude access to multiple AI models (Gemini, OpenAI, OpenRouter, Ollama) for enhanced development capabilities.

Quick Start

npx zen-mcp-server-199bio

That's it! No Docker required. 🎉

What is Zen MCP Server?

Zen MCP Server gives Claude Desktop access to multiple AI models for:

  • 🧠 Extended reasoning with Gemini 2.0 Pro's thinking mode
  • 💬 Collaborative development with multiple AI perspectives
  • 🔍 Code review and architectural analysis
  • 🐛 Advanced debugging with specialized models
  • 📊 Large context analysis (Gemini: 1M tokens, O3: 200K tokens)
  • 🔄 Conversation threading - AI models maintain context across multiple calls

Features

  • No Docker required - Runs directly with Python
  • 🚀 Fast startup - No container overhead
  • 💾 Lightweight - Minimal resource usage
  • 🔧 Auto-setup - Handles Python dependencies automatically
  • 📦 Virtual environment - Isolated dependencies
  • 🌍 Cross-platform - Works on macOS, Windows, Linux

First Time Setup

On first run, the wrapper will:

  1. Check Python 3.11+ is installed
  2. Clone Zen MCP Server to ~/.zen-mcp-server
  3. Create .env file and prompt for API keys
  4. Set up Python virtual environment
  5. Install dependencies automatically

Configuration

1. Get API Keys (at least one required)

Choose one or more:

2. Configure API Keys

Edit ~/.zen-mcp-server/.env:

# Option 1: Native APIs GEMINI_API_KEY=your_gemini_key_here OPENAI_API_KEY=your_openai_key_here # Option 2: OpenRouter (for multiple models) OPENROUTER_API_KEY=your_openrouter_key_here # Option 3: Local models (Ollama example) CUSTOM_API_URL=http://localhost:11434/v1 CUSTOM_MODEL_NAME=llama3.2

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{ "mcpServers": { "zen": { "command": "npx", "args": ["zen-mcp-server-199bio"] } } }

Location of config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Usage with Claude CLI

claude mcp add zen "npx" "zen-mcp-server-199bio"

Available Tools

Once configured, Claude will have access to these tools:

  • zen - Default tool for quick AI consultation (alias for chat)
  • chat - Collaborative development discussions
  • thinkdeep - Extended reasoning (Gemini 2.0 Pro)
  • codereview - Professional code review
  • precommit - Pre-commit validation
  • debug - Advanced debugging assistance
  • analyze - Smart file and codebase analysis

Quick Usage: Just say "use zen" for quick AI consultations!

Troubleshooting

Python not found?

  • macOS: brew install python@3.11
  • Windows: Download from python.org
  • Linux: sudo apt install python3.11

Dependencies issue?

The wrapper tries to install automatically, but if it fails:

cd ~/.zen-mcp-server python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -r requirements.txt

API key issues?

  • Check ~/.zen-mcp-server/.env has valid keys
  • Ensure at least one API key is configured
  • For OpenRouter, check your credits/limits

Requirements

  • Python 3.11+
  • Node.js >= 14.0.0
  • Git
  • At least one API key (Gemini, OpenAI, or OpenRouter)

Why No Docker?

We removed Docker because:

  • Faster startup - No container overhead
  • Less resource usage - No Redis, no Docker daemon
  • Simpler - Just Python and your API keys
  • Same features - Conversation threading works perfectly with in-memory storage

License

Apache 2.0 - See LICENSE

-
security - not tested
F
license - not found
-
quality - not tested

Gives Claude access to multiple AI models (Gemini, OpenAI, OpenRouter, Ollama) for enhanced development capabilities including extended reasoning, collaborative development, code review, and advanced debugging.

  1. Quick Start
    1. What is Zen MCP Server?
      1. Features
        1. First Time Setup
          1. Configuration
            1. Get API Keys (at least one required)
            2. Configure API Keys
          2. Usage with Claude Desktop
            1. Usage with Claude CLI
              1. Available Tools
                1. Troubleshooting
                  1. Python not found?
                  2. Dependencies issue?
                  3. API key issues?
                2. Requirements
                  1. Why No Docker?
                    1. Links
                      1. License

                        Related MCP Servers

                        • -
                          security
                          F
                          license
                          -
                          quality
                          A multi-model research agent platform supporting Claude, Gemini, and OpenAI models with web search capabilities, thinking-enabled features, and citation support for advanced research workflows.
                          Last updated -
                          6
                          TypeScript
                        • -
                          security
                          A
                          license
                          -
                          quality
                          Connects Claude Code with multiple AI models (Gemini, Grok-3, ChatGPT, DeepSeek) simultaneously, allowing users to get diverse AI perspectives, conduct AI debates, and leverage each model's unique strengths.
                          Last updated -
                          7
                          Python
                          MIT License
                        • -
                          security
                          F
                          license
                          -
                          quality
                          A Model Context Protocol server that gives Claude access to multiple AI models (Gemini, OpenAI, OpenRouter) for enhanced code analysis, problem-solving, and collaborative development through AI orchestration with conversations that continue across tasks.
                          Last updated -
                          2,294
                          Python
                          • Apple
                        • A
                          security
                          A
                          license
                          A
                          quality
                          Pairs Claude Code with Google's Gemini AI for complementary code analysis, enabling intelligent routing where Claude handles local-context operations while Gemini leverages its 1M token context for distributed system debugging and long-trace analysis.
                          Last updated -
                          10
                          37
                          TypeScript
                          MIT License

                        View all related MCP servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/199-biotechnologies/mcp-zen-npx'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server