The Zen MCP Server acts as a universal bridge, allowing users to connect their primary AI assistant—such as Claude Desktop—to a wide variety of other powerful AI brains simultaneously. Instead of being locked into a single model, this tool lets a primary assistant "call a friend" from OpenAI, Google Gemini, or OpenRouter to help finish complex tasks. It essentially turns a single chat interface into a command center for multiple intelligence systems, making it easy to get a second opinion or a specialized answer without ever switching tabs. For developers, this server unlocks a specialized suite of tools designed to streamline the coding and analysis process. It provides dedicated commands like `thinkdeep` for extended reasoning through Gemini 2.0 Pro, `codereview` for professional-grade architectural feedback, and `debug` for hunting down stubborn bugs. By utilizing models with massive context windows—up to one million tokens—the server enables the deep analysis of entire codebases or long documentation sets that would typically overwhelm standard AI configurations. The architecture of this specific version focuses on accessibility and performance by removing the need for Docker or heavy containerization. It runs directly via Python with a lightweight NPX wrapper, featuring automatic dependency management and isolated virtual environments for a "plug-and-play" experience. Because it supports conversation threading and in-memory storage, it maintains context across multiple tool calls, allowing different models to collaborate on a single problem while keeping local resource usage to a minimum.
Category: AI & LLM Tooling
Tags: code-review, debugging, llm, model-routing, multi-agent
npx: bash npx zen-mcp-server-199bio On the first run, the wrapper will automatically: 1. Check for Python 3.11+. 2. Clone the server to ~/.zen-mcp-server. 3. Create a .env file and prompt for API keys. 4. Set up a Python virtual environment and install dependencies. ---claude_desktop_config.json file: json { "mcpServers": { "zen": { "command": "npx", "args": ["zen-mcp-server-199bio"], "env": { "GEMINI_API_KEY": "your_gemini_key_here", "OPENAI_API_KEY": "your_openai_key_here", "OPENROUTER_API_KEY": "your_openrouter_key_here" } } } } Config File Locations: * macOS: ~/Library/Application Support/Claude/claude_desktop_config.json * Windows: %APPDATA%\Claude\claude_desktop_config.json * Linux: ~/.config/Claude/claude_desktop_config.jsonbash claude mcp add zen "npx" "zen-mcp-server-199bio" ---zen: Default tool for quick AI consultation (alias for chat). * chat: Collaborative development discussions. * thinkdeep: Extended reasoning (utilizes Gemini 2.0 Pro's thinking mode). * codereview: Professional code review and architectural analysis. * precommit: Pre-commit validation. * debug: Advanced debugging assistance with specialized models. * analyze: Smart file and codebase analysis. ---thinkdeep tool to invoke Gemini 2.0 Pro’s thinking mode directly within your Claude Desktop environment. You get the benefit of Claude’s UI and file handling combined with Gemini’s specialized reasoning capabilities. Example: You are designing a multi-region database failover strategy. You tell Claude: "Use the thinkdeep tool to analyze my current proposal and look for potential data consistency issues during a partial network partition."analyze tool through Zen, you can leverage Gemini’s 1M+ token context window. This allows the AI to "see" the entire codebase at once without you having to manually copy-paste dozens of files. Example: You are refactoring a legacy enterprise app. You prompt Claude: "Use the analyze tool via Zen to scan the entire project folder and list every instance where the deprecated 'UserAuth' class is instantiated, then suggest a migration path for each."codereview tool enables you to send your code to a completely different model family (e.g., sending Claude-generated code to GPT-4o or an OpenRouter-hosted model). This provides a cross-platform validation of the code's quality. Example: After Claude helps you write a custom encryption wrapper, you say: "Now use the codereview tool via Zen to have an OpenAI model audit this code for cryptographic vulnerabilities and PEP8 compliance."Part of MCP Servers
Zen MCP Server is a bridge that connects your primary MCP client to external model providers including Google Gemini, OpenAI, and OpenRouter. It exposes specialized tools like thinkdeep, codereview, debug, and analyze, enabling developers to run cross-model reviews, extended reasoning tasks, and multi-file code auditing within a single environment.
You can install and run it using npx by passing zen-mcp-server-199bio into your Claude Desktop configuration file or through the Claude CLI. You must have Python 3.11 or higher, Node.js 14 or higher, Git, and at least one API key configured for OpenAI, Gemini, or OpenRouter.
Zen MCP Server works with any client compatible with the Model Context Protocol that supports standard input/output execution, such as Claude Desktop and the Claude CLI. It runs locally via an NPX wrapper and Python virtual environment.
The server includes several operational tools: zen and chat for interactive discussions, thinkdeep for Gemini thinking mode reasoning, codereview for architectural analysis, precommit for commit validation, debug for cross-model bug hunting, and analyze for codebase scanning.
Yes, Zen MCP Server is open source software. The repository is publicly hosted and maintained on GitHub under the MCP-Mirror organization as 199-biotechnologies_mcp-zen-plus.