Adamwattis MCP Proxy Server

🚀 MCP 代理服務器

MCP 代理服務器是一個強大的工具，它能聚合並提供多個 MCP 資源服務器的服務。通過統一接口，它實現了對多個 MCP 資源服務器的集中管理，解決了資源分散、管理不便的問題，為用戶提供了高效便捷的使用體驗。

🚀 快速開始

MCP 代理服務器作為中央樞紐，具備連接和管理多個 MCP 資源服務器的能力。它通過統一接口暴露綜合功能，處理請求到適當後端服務器的路由，並聚合來自多個來源的響應。

✨ 主要特性

資源管理

• 自動發現並連接多個 MCP 資源服務器。
• 聚合所有連接服務器的資源，實現資源的統一獲取。
• 維持服務器之間一致的 URI 方案，便於資源的管理和訪問。
• 高效處理資源路由和解析，確保資源的準確獲取。

工具聚合

• 暴露所有連接服務器中的工具，方便用戶統一調用。
• 將工具調用精準路由到適當的後端服務器，提高工具使用效率。
• 維護工具狀態並處理響應，保障工具的穩定運行。

提示處理

• 聚合來自所有連接服務器的提示，為用戶提供全面的信息。
• 將提示請求路由到合適的後端，確保提示的準確性。
• 處理多臺服務器的提示響應，提高提示處理的效率。

📦 安裝指南

配置服務器

該服務器需要一個 JSON 配置文件，指定要連接的 MCP 服務器。複製示例配置並根據需要進行修改：

cp config.example.json config.json

示例配置結構：

{
  "servers": [
    {
      "name": "Server 1",
      "transport": {
        "command": "/path/to/server1/build/index.js"
      }
    },
    {
      "name": "Server 2",
      "transport": {
        "command": "server2-command",
        "args": ["--option1", "value1"]
      }
    }
  ]
}

配置文件在運行服務器時必須提供：

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

與 Claude Desktop 集成

要與 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"
      }
    }
  }
}

💻 使用示例

開發環境搭建

安裝依賴項

npm install

構建服務器

npm run build

帶自動重建進行開發

npm run watch

調試

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

npm run inspector

Inspector 將提供訪問調試工具的 URL，在您的瀏覽器中打開即可。