Claude MCP服务器网关
用于Claude Desktop、Claude Code、Cline和Roo的Python MCP服务器网关。它不是在启动时加载所有MCP工具,而是按需加载它们。
适用于: Claude Desktop(应用程序)、Claude Code(终端)、Cline和Roo(VSCode扩展)
兼容性
| 平台 | 配置文件 | 支持 |
|---|---|---|
| 克劳德桌面 | claude_desktop_config.json | 是的 |
| 克劳德代码 | .claude.json 或 .mcp.json | 是的 |
| Cline(VSCode) | cline_mcp_settings.json | 是的 |
MCP服务器问题
当您将多个MCP服务器连接到Claude时:
- GitHub MCP服务器:51个工具
- Slack MCP服务器:20个工具
- 谷歌云端硬盘MCP:15个工具
- 文件系统MCP:12个工具
在您开始之前,已经加载了100多个MCP工具定义。每个工具的JSON模式都会消耗令牌。
这个Claude MCP服务器网关做什么
网关充当具有3个工具的单个MCP服务器:
list_available_mcps-显示已配置的MCP服务器load_mcp_tools-从特定MCP服务器加载工具call_mcp_tool-执行该工具
模型上下文协议服务器仅在Claude实际需要时启动。
设置
需求
- Python 3.11+(适用于MCP Python SDK)
- Claude Desktop、Claude Code或Cline/Roo
- 您要使用的MCP服务器
安装
git clone https://github.com/bzsasson/claude-mcp-server-gateway.git
cd claude-mcp-server-gateway
python3.11 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install mcp python-dotenv配置API密钥
cp .env.example .env
# Edit .env with your tokensClaude Desktop MCP服务器配置
添加到您的Claude Desktop配置中:
苹果电脑: ~/Library/Application Support/Claude/claude_desktop_config.json\ 视窗: %APPDATA%\Claude\claude_desktop_config.json\ Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"gateway": {
"command": "/path/to/.venv/bin/python",
"args": ["/path/to/claude-mcp-server-gateway/dcl_wrapper.py"]
}
}
}重新启动克劳德桌面。
如何将MCP服务器添加到Claude Code
Claude Code MCP服务器设置使用了类似的配置,并增加了一个字段。
用户级配置(所有项目)
编辑 ~/.claude.json:
{
"mcpServers": {
"gateway": {
"type": "stdio",
"command": "/path/to/.venv/bin/python",
"args": ["/path/to/claude-mcp-server-gateway/dcl_wrapper.py"]
}
}
}项目级配置
对于特定于项目的MCP服务器,创建 .mcp.json 在项目根目录中:
{
"mcpServers": {
"gateway": {
"type": "stdio",
"command": "/path/to/.venv/bin/python",
"args": ["/path/to/claude-mcp-server-gateway/dcl_wrapper.py"]
}
}
}使用项目范围的服务器时,Claude Code将提示批准。
替代方案:Claude Code CLI
# Add the gateway using CLI
claude mcp add gateway --scope user \
--command /path/to/.venv/bin/python \
-- /path/to/claude-mcp-server-gateway/dcl_wrapper.py
# Verify it's added
claude mcp listCline/Roo MCP服务器配置
对于Cline和Roo(VSCode扩展),MCP服务器网关配置如下:
苹果电脑: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json\ 视窗: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json\ Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
{
"mcpServers": {
"gateway": {
"command": "/path/to/.venv/bin/python",
"args": ["/path/to/claude-mcp-server-gateway/dcl_wrapper.py"],
"disabled": false
}
}
}更新后重新启动VSCode。
运作原理
- Claude开始-看到网关(3个工具)
- 你问起GitHub——克劳德打电话
list_available_mcps - Claude看到GitHub可用-调用
load_mcp_tools("github") - Gateway返回GitHub的工具列表
- 克劳德选择了正确的工具调用
call_mcp_tool("github", "search_repositories", {...}) - Gateway启动GitHub MCP,运行该工具,返回结果
将MCP服务器添加到网关
编辑 dcl_wrapper.py 并添加到 MCP_SERVERS 字典
MCP_SERVERS = {
"your-server": {
"command": "npx",
"args": ["-y", "your-mcp-package"],
"env": {
"API_KEY": os.getenv("YOUR_API_KEY", "")
},
"description": "What it does"
}
}当前配置的服务器
- GitHub
- 松弛
- 谷歌驱动器
- 文件系统
- Postgres
- 记忆
- 勇敢的搜寻
(检查 dcl_wrapper.py 完整列表)
局限性
- 首次使用工具时出现轻微延迟(服务器启动)
- 每个MCP服务器连接都是临时的
- 通话之间没有持久性
故障排除
网关未出现
- 检查配置中指向虚拟环境的Python路径
- 验证
dcl_wrapper.py路径正确 - 完全重新启动克劳德桌面/代码/VCode
MCP服务器连接错误
- 在中检查API密钥
.env文件 - 验证MCP服务器包是否已安装
- 检查网关日志是否有错误
Claude Code特定问题
- 确保包括
"type": "stdio"在配置中 - 对于项目配置,在提示时批准
- 使用
claude mcp list验证安装
文件
dcl_wrapper.py-网关服务器.env-您的API密钥requirements.txt-Python依赖关系
许可证
麻省理工学院
