MCP Gateway

🚀 MCP 服務器網關

MCP 服務器網關是一個服務網關，用於將基於標準輸入輸出（stdio）的模型上下文協議（MCP）實現（如Claude Desktop）與基於 HTTP/SSE（Server-Sent Events）的 MCP 服務器進行橋接。它有效解決了協議兼容性問題，因為目前 Claude Desktop 僅支持基於 stdio 的 MCP 服務器。相關討論見此處。

🚀 快速開始

MCP 服務器網關可使 Claude Desktop 與任何 HTTP/SSE MCP 服務器通信，解決協議兼容性問題。下面將詳細介紹其安裝、配置等步驟。

✨ 主要特性

• 協議轉換：Claude Desktop 應用程序當前僅支持基於 stdio 的 MCP 服務器協議，而許多 MCP 服務器使用 HTTP 結合 SSE（Server-Sent Events）傳輸協議。此網關充當協議轉換器，具體功能如下：
  1. 接受來自 Claude Desktop 的標準輸入輸出。
  2. 轉換並轉發請求到 HTTP/SSE MCP 服務器。
  3. 將 SSE 響應轉換回標準輸入輸出格式供 Claude Desktop 使用。

📦 安裝指南

使用 npm 全局安裝網關：

npm install -g @mcphub/gateway

📚 詳細文檔

配置步驟

1. 查找網關路徑

安裝完成後，通過以下命令查找 npm 安裝的網關位置：

# 顯示全局包的根目錄
npm root -g

# 網關位於：
<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 中的路徑替換為你實際找到的路徑。

3. 配置 MCP 服務器連接

網關使用環境變量來指定要連接到哪個 MCP 服務器：

# 設置 MCP 服務器 URL（可選）
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. 找不到網關路徑

# 列出所有全局包並查找@mcphub/gateway
npm list -g

# 或者專門查看網關
npm list -g @mcphub/gateway

2. 驗證你的 Node.js 安裝

# 檢查 Node 版本
node --version

# 檢查 npm 版本
npm --version

3. 常見問題

• 如果在 macOS 上使用 Homebrew，請確保 Node.js 已正確鏈接：

brew doctor
brew link node

• 如果遇到權限錯誤，可能需要使用 sudo 進行安裝

📄 許可證

Apache 2.0 License

🔗 支持

如果你遇到問題或有任何疑問，可在 GitHub 上提交問題。

🌟 貢獻

歡迎貢獻！請隨意提交 Pull Request。