MCP Proxy Server

🚀 MCP 代理服務器

MCP 代理服務器是一個強大的工具，它能夠聚合並通過單個接口提供多個 MCP 資源服務器的服務。作為中心樞紐，它可以連接和管理多個 MCP 資源服務器，通過統一接口暴露綜合功能，處理請求路由，並聚合多來源的響應。

🚀 快速開始

MCP 代理服務器使用前需進行配置，配置完成後即可運行。以下是詳細步驟：

1. 複製示例配置文件並按需修改：

cp config.example.json config.json

2. 運行服務器時提供配置文件：

MCP_CONFIG_PATH=./config.json mcp-proxy-server

✨ 主要特性

資源管理

• 發現並連接多個 MCP 資源服務器。
• 聚合所有連接服務器的資源。
• 維持服務器之間一致的 URI 方案。
• 處理資源路由和解析。

工具聚合

• 暴露所有連接服務器的工具。
• 將工具調用路由到適當的後端服務器。
• 維護工具狀態並處理響應。

提示處理

• 聚合所有服務器的提示。
• 將提示請求路由到合適的後端。
• 處理多服務器提示響應。

📦 安裝指南

與 Claude Desktop 一起使用

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

添加如下服務器配置：

{
  "mcpServers": {
    "mcp-proxy": {
      "command": "/path/to/mcp-proxy-server/build/index.js",
      "env": {
        "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
        "KEEP_SERVER_OPEN": "1"
      }
    }
  }
}

注意事項

• KEEP_SERVER_OPEN 會在客戶端斷開時保持 SSE 運行，對於多個客戶端連接到 MCP 代理很有用。

💻 使用示例

基礎用法

配置文件示例

{
  "servers": [
    {
      "name": "Server 1",
      "transport": {
        "command": "/path/to/server1/build/index.js"
      }
    },
    {
      "name": "Server 2",
      "transport": {
        "command": "server2-command",
        "args": ["--option1", "value1"],
        "env": ["SECRET_API_KEY"]
      }
    },
    {
      "name": "Example Server 3",
      "transport": {
        "type": "sse",
        "url": "http://localhost:8080/sse"
      }
    }
  ]
}

高級用法

運行服務器

MCP_CONFIG_PATH=./config.json mcp-proxy-server

🔧 技術細節

開發步驟

安裝依賴項

npm install

構建服務器

npm run build

帶有自動重建的開發

npm run watch

帶有連續運行的開發

# 標準輸入輸出
npm run dev
# SSE
npm run dev:sse

調試

由於 MCP 服務器通過 stdio 通信，調試可能具有挑戰性。我們建議使用 MCP Inspector，它作為包腳本可用：

npm run inspector

Inspector 將提供訪問瀏覽器中的調試工具的 URL。