MCP Proxy Nodejs

🚀 MCP SSE 代理

MCP SSE 代理是一個模型上下文協議（MCP）服務器，作為代理橋樑，將基於標準輸入輸出（STDIO）的 MCP 客戶端與基於服務器發送事件（SSE）的 MCP 服務器連接起來。這使得僅支持 STDIO 傳輸的 MCP 客戶端能夠連接到使用 SSE 傳輸的遠程 MCP 服務器。

🚀 快速開始

MCP SSE 代理在兩種不同的 MCP 傳輸協議之間架起了橋樑：

• STDIO 傳輸：供本地 MCP 客戶端（如 Claude Desktop）使用。
• SSE 傳輸：供可通過 HTTP/HTTPS 訪問的遠程 MCP 服務器使用。

此代理允許你從僅支持基於 STDIO 的 MCP 連接的應用程序中使用暴露 SSE 端點的遠程 MCP 服務器。

✨ 主要特性

• 全面支持 MCP 協議：代理所有 MCP 功能，包括：
  • 工具（列出和調用）
  • 資源（列出和讀取）
  • 資源模板（列出）
  • 提示（列出和獲取）
• 支持身份驗證：為 SSE 端點提供可選的 API 密鑰身份驗證。
• 錯誤處理：具備全面的錯誤處理和詳細的日誌記錄。
• 優雅關閉：在進程終止時進行適當的清理。
• 可配置：可通過命令行參數或環境變量進行靈活配置。

📦 安裝指南

前提條件

• Node.js >= 18.0.0
• npm 或 yarn

安裝步驟

1. 克隆或下載此倉庫。
2. 安裝依賴項：

npm install

💻 使用示例

命令行參數

node server/index.js <SERVER_NAME> <SSE_URL> [API_KEY]

參數說明：

• SERVER_NAME：MCP 服務器的顯示名稱。
• SSE_URL：遠程 SSE MCP 服務器端點的 URL。
• API_KEY：（可選）用於身份驗證的 API 密鑰。

示例：

node server/index.js "My Remote MCP Server" "https://api.example.com/mcp/sse" "your-api-key"

環境變量

你也可以使用環境變量：

export SERVER_NAME="My Remote MCP Server"
export SSE_URL="https://api.example.com/mcp/sse"
export API_KEY="your-api-key"
node server/index.js

MCP 客戶端配置

要將此代理與像 Claude Desktop 這樣的 MCP 客戶端一起使用，請在你的 MCP 配置中添加以下內容：

{
  "mcpServers": {
    "remote-server": {
      "command": "node",
      "args": [
        "/path/to/mcp-proxy-node/server/index.js",
        "Remote Server Name",
        "https://your-remote-server.com/mcp/sse",
        "your-api-key"
      ]
    }
  }
}

身份驗證

代理支持 Bearer 令牌身份驗證。當提供 API 密鑰時，它將在 HTTP 請求中作為 Authorization: Bearer <API_KEY> 頭髮送，並在 EventSource 連接中作為身份驗證頭。

創建桌面擴展（.dxt）

此 MCP 代理可以打包為桌面擴展，以便在 Claude Desktop 和其他支持 MCP 的應用程序中一鍵安裝。

完整指南請參閱：Desktop Extensions: One-click MCP server installation for Claude Desktop

前提條件

安裝依賴項：

npm install

安裝 DXT CLI 工具：

npm install -g @anthropic-ai/dxt

創建 DXT 文件的步驟

1. 初始化 DXT 配置（如有需要）：

dxt init

注意：此項目已包含 manifest.json 文件，因此可能不需要初始化。

2. 驗證清單文件：

dxt validate

3. 打包擴展：

dxt pack

4. 測試擴展：

• 該命令將生成一個 .dxt 文件。
• 將 .dxt 文件拖到 Claude Desktop 的設置窗口中。
• 點擊“安裝”以測試擴展。

快速安裝（可選）

如果你不想自己構建擴展，可以直接將預構建的 mcp-proxy-node.dxt 文件拖到 Claude Desktop 的設置窗口中進行立即安裝。

截圖

MCP SSE 代理擴展在 Claude Desktop 中安裝後的樣子。用戶可以通過直觀的界面輕鬆配置服務器名稱、SSE URL 和 API 密鑰。

🔧 技術細節

架構

MCP 客戶端（STDIO） ←→ MCP SSE 代理 ←→ 遠程 MCP 服務器（SSE）

代理由兩個主要組件組成：

1. MCP 服務器：接受來自本地 MCP 客戶端的 STDIO 連接。
2. MCP 客戶端：連接到遠程 SSE MCP 服務器。

傳輸協議

• 輸入：STDIO 傳輸（標準輸入/輸出）。
• 輸出：SSE 傳輸（通過 HTTP/HTTPS 的服務器發送事件）。

錯誤處理

代理包含全面的錯誤處理：

• 與遠程 SSE 服務器的連接失敗。
• 無效的 URL 格式。
• 身份驗證錯誤。
• 請求/響應解析錯誤。
• 當遠程功能不可用時進行優雅降級。

日誌記錄

通過 console.error() 提供詳細的日誌記錄，用於調試：

• 連接狀態。
• 請求/響應詳細信息。
• 帶有堆棧跟蹤的錯誤信息。
• 性能指標。

📚 詳細文檔

MCPSSEProxy 類

構造函數

new MCPSSEProxy(sseUrl, apiKey, serverName)

• sseUrl（字符串）：SSE MCP 服務器的 URL。
• apiKey（字符串，可選）：用於身份驗證的 API 密鑰。
• serverName（字符串）：代理服務器的顯示名稱。

方法

• initialize()：初始化客戶端和服務器連接。
• run()：啟動代理服務器。
• close()：優雅地關閉代理。
• setupProxyHandlers()：配置請求處理程序。

項目結構

mcp-proxy-node/
├── server/
│   └── index.js          # 主代理服務器實現
├── package.json          # 項目配置和依賴項
├── manifest.json         # 用於 MCP 客戶端集成的 DXT 清單
├── favicon.png          # 項目圖標
└── README.md            # 本文件

依賴項

• @modelcontextprotocol/sdk：官方的 Node.js MCP SDK。

貢獻代碼

1. 分叉倉庫。
2. 創建功能分支。
3. 進行更改。
4. 徹底測試。
5. 提交拉取請求。

故障排除

常見問題

1. 連接被拒絕

• 驗證 SSE URL 是否正確且可訪問。
• 檢查遠程服務器是否正在運行。
• 確保防火牆/網絡設置允許連接。

2. 身份驗證錯誤

• 驗證 API 密鑰是否正確。
• 檢查遠程服務器是否需要身份驗證。
• 確保 API 密鑰格式符合服務器要求。

3. 沒有可用的工具/資源

• 檢查遠程服務器是否實際提供工具/資源。
• 驗證遠程服務器是否正常響應。
• 檢查代理日誌中的錯誤消息。

4. 性能問題

• 監控到遠程服務器的網絡延遲。
• 檢查遠程服務器是否有速率限制。
• 對於高頻使用情況，考慮使用連接池。

調試

通過查看控制檯輸出啟用詳細日誌記錄。代理會記錄：

• 連接嘗試和結果。
• 請求/響應詳細信息。
• 帶有堆棧跟蹤的錯誤消息。
• 性能計時。

加入我們的社區獲取幫助和更新

👉 Slack 社區 - AI in Ads

查看我們的其他項目

👉 Facebook Ads MCP - Facebook Ads MCP 👉 Google Ads MCP - Google Ads MCP

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

支持

如有問題和疑問：

• 查看上述故障排除部分。
• 查看控制檯日誌以獲取錯誤詳細信息。
• 確保你的 Node.js 版本符合要求（>= 18.0.0）。
• 驗證遠程 SSE 服務器是否與 MCP 協議兼容。

兼容性

• Node.js：>= 18.0.0
• MCP 協議：與 MCP SDK v1.13.2+ 兼容
• 平臺：macOS、Windows、Linux
• Claude Desktop：>= 0.10.0

💖 為 MCP 社區精心打造