Zen MCP Server NPX Wrapper

适用于Zen MCP Server的易于使用的NPX包装器——为Claude提供多种AI模型（Gemini、OpenAI、OpenRouter、Ollama）以增强开发能力。

快速开始

npx zen-mcp-server-199bio

就这样！无需Docker。🎉

什么是Zen MCP Server？

Zen MCP Server为Claude Desktop提供了访问多种AI模型的能力，用于：

• 🧠 扩展推理：使用Gemini 2.0 Pro的思考模式
• 💬 协作开发：利用多个AI视角
• 🔍 代码审查和架构分析
• 🐛 高级调试：使用专门的模型
• 📊 大上下文分析（Gemini：1M令牌，O3：200K令牌）
• 🔄 对话线程：AI模型在多次调用中保持上下文

特性

• ✅ 无需Docker：直接使用Python运行
• 🚀 快速启动：没有容器开销
• 💾 轻量级：最小资源使用
• 🔧 自动设置：自动处理Python依赖项
• 📦 虚拟环境：隔离依赖项
• 🌍 跨平台：支持macOS、Windows、Linux

首次设置

首次运行时，包装器会：

1. 检查是否安装了Python 3.11+
2. 将Zen MCP Server克隆到~/.zen-mcp-server
3. 创建.env文件并提示输入API密钥
4. 设置Python虚拟环境
5. 自动安装依赖项

快速安装

1. 获取API密钥（至少需要一个）

选择一个或多个：

• Gemini：Google AI Studio
• OpenAI：OpenAI Platform
• OpenRouter：OpenRouter（访问100+模型）

2. 添加到Claude Desktop

添加到你的claude_desktop_config.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"
      }
    }
  }
}

就这样！只需重启Claude Desktop即可开始使用。

配置文件位置：

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

使用Claude CLI

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

可用工具

配置完成后，Claude将可以访问以下工具：

• zen - 默认工具，用于快速AI咨询（聊天别名）
• chat - 协作开发讨论
• thinkdeep - 扩展推理（Gemini 2.0 Pro）
• codereview - 专业代码审查
• precommit - 提交前验证
• debug - 高级调试辅助
• analyze - 智能文件和代码库分析

快速使用：只需说“使用zen”进行快速AI咨询！

故障排除

未找到Python？

• macOS：brew install python@3.11
• Windows：从python.org下载
• Linux：sudo apt install python3.11

依赖问题？

包装器尝试自动安装，但如果失败：

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

API密钥问题？

• 检查~/.zen-mcp-server/.env是否有有效的密钥
• 确保至少配置了一个API密钥
• 对于OpenRouter，请检查您的信用额度/限制

要求

• Python 3.11+
• Node.js >= 14.0.0
• Git
• 至少一个API密钥（Gemini、OpenAI或OpenRouter）

为什么没有Docker？

我们移除了Docker，因为：

• 更快的启动：没有容器开销
• 更少的资源使用：没有Redis，没有Docker守护进程
• 更简单：只有Python和您的API密钥
• 相同的功能：内存存储中的对话线程工作完美

链接

• Zen MCP Server
• MCP Zen Plus
• Model Context Protocol

许可证

Apache 2.0 - 查看LICENSE