MCP Server Gateway

MCP 服务网关

一项网关服务，用于桥接 Claude Desktop 中基于 stdio 的模型上下文协议（MCP）实现与基于 HTTP/SSE 的 MCP 服务。由于 Claude Desktop 目前仅支持基于 stdio 的 MCP 服务，此服务解决了协议兼容性问题。请参阅此处的讨论。

为什么需要此网关？

Claude Desktop App 目前仅支持 MCP 服务使用 stdio 协议，而许多 MCP 服务使用基于 HTTP 的服务器发送事件（SSE）传输。此网关充当协议转换器，通过以下方式让 Claude Desktop 能够与任何 HTTP/SSE MCP 服务通信：

1. 接收来自 Claude Desktop 的 stdio 输入
2. 将请求转换并转发至 HTTP/SSE MCP 服务
3. 将 SSE 响应转换回 stdio 格式，以供 Claude Desktop 使用

安装

使用 npm 全局安装网关：

npm install -g @mcphub/gateway

配置

1. 查找网关路径

安装后，使用以下命令查找 npm 安装网关的位置：

# This shows the root directory of global packages
npm root -g

# The gateway will be located at:
<npm_global_root>/@mcphub/gateway/dist/src/mcphub-gateway.js

常见的全局包位置：

• macOS（Homebrew Node）：/opt/homebrew/lib/node_modules/@mcphub/gateway/dist/src/mcphub-gateway.js
• macOS（默认）：/usr/local/lib/node_modules/@mcphub/gateway/dist/src/mcphub-gateway.js
• Windows：%AppData%\npm\node_modules\@mcphub\gateway\dist\src\mcphub-gateway.js

验证安装和路径：

npm list -g @mcphub/gateway

2. 配置 Claude Desktop

创建或更新 Claude Desktop 配置文件：

在 macOS 上

位置：~/Library/Application Support/Claude Desktop/config.json

在 Windows 上

位置：%APPDATA%\Claude Desktop\config.json

添加以下配置（使用你在步骤 1 中找到的路径）：

{
  "mcpServers": {
    "server-name": {
      "command": "node",
      "args": ["/opt/homebrew/lib/node_modules/@mcphub/gateway/dist/src/mcphub-gateway.js"]
    }
  }
}

注意：将 args 中的路径替换为你在步骤 1 中找到的实际路径。

3. 配置 MCP 服务连接

网关使用环境变量指定要连接的 MCP 服务：

# Set the MCP server URL (optional)
export MCP_SERVER_URL=https://your-mcp-server.com/api/mcp

默认情况下，网关会连接到 MCP Hub 服务 https://server.mcphub.ai/api/mcp，该服务提供对各种预配置 MCP 服务的访问。

4. 启动 Claude Desktop

启动或重启 Claude Desktop 以应用更改。

故障排除

1. 如果找不到网关路径：

   # List all global packages and look for @mcphub/gateway
   npm list -g
   
   # Or specifically check the gateway
   npm list -g @mcphub/gateway
   

2. 验证 Node.js 安装：

   # Check Node version
   node --version
   
   # Check npm version
   npm --version
   

3. 常见问题：

   • 如果在 macOS 上使用 Homebrew，请确保 Node.js 已正确链接：

     brew doctor
     brew link node
     

   • 如果遇到权限错误，可能需要使用 sudo 进行安装

许可证

Apache 2.0 许可证

支持

如果遇到任何问题或有疑问：

• 在 GitHub 上提交问题

贡献

欢迎贡献！请随时提交 Pull Request。