README.md•4.3 kB
# Zen MCP Server NPX Wrapper
Easy-to-use NPX wrapper for [Zen MCP Server](https://github.com/BeehiveInnovations/zen-mcp-server) - Give Claude access to multiple AI models (Gemini, OpenAI, OpenRouter, Ollama) for enhanced development capabilities.
## Quick Start
```bash
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
## Quick Install
### 1. Get API Keys (at least one required)
Choose one or more:
- **Gemini**: [Google AI Studio](https://makersuite.google.com/app/apikey)
- **OpenAI**: [OpenAI Platform](https://platform.openai.com/api-keys)
- **OpenRouter**: [OpenRouter](https://openrouter.ai/) (access to 100+ models)
### 2. Add to Claude Desktop
Add to your `claude_desktop_config.json`:
```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"
}
}
}
}
```
That's it! Just restart Claude Desktop and you're ready to go.
**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
```bash
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](https://www.python.org/downloads/)
- Linux: `sudo apt install python3.11`
### Dependencies issue?
The wrapper tries to install automatically, but if it fails:
```bash
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
## Links
- [Zen MCP Server](https://github.com/BeehiveInnovations/zen-mcp-server)
- [MCP Zen Plus](https://github.com/199-biotechnologies/mcp-zen-plus)
- [Model Context Protocol](https://modelcontextprotocol.io/)
## License
Apache 2.0 - See [LICENSE](https://github.com/BeehiveInnovations/zen-mcp-server/blob/main/LICENSE)