MCP Server Proxy

🚀 MCP 服務器代理

MCP 服務器代理是一個強大的代理服務器，它能夠連接到多個 MCP 服務器，並提供統一接口，方便各類工具進行訪問，極大地提升了多服務器管理的便捷性。

🚀 快速開始

MCP 服務器代理可輕鬆連接多個 MCP 服務器，提供統一接口供工具訪問。你可以按照下面的步驟快速上手。

✨ 主要特性

• 可同時連接多個 MCP 服務器，實現多服務器的集中管理。
• 支持多個配置文件，滿足不同場景的多樣化需求。
• 工具名稱帶有服務器名稱的前綴，便於清晰區分不同服務器的工具。
• 支持在“stdio”或“SSE”模式下運行，靈活適配不同的使用場景。
• 基於配置文件進行管理，方便快捷地對服務器進行配置和調整。

📦 安裝指南

在項目根目錄下，執行以下命令進行安裝：

npm install

💻 使用示例

基礎用法

命令行選項

服務器可以通過以下命令行選項啟動：

# 使用默認設置啟動
node dist/server.js

# 使用特定配置文件啟動
node dist/server.js --profile developer
# 或者
node dist/server.js -p developer

# 在 SSE 模式下啟動
node dist/server.js --mode sse
# 或者
node dist/server.js -m sse

# 在 SSE 模式下使用自定義端口和主機
node dist/server.js --mode sse --port 8080 --host 0.0.0.0

# 組合選項
node dist/server.js --profile developer --mode sse --port 8080

可用選項：

• -p, --profile <name>: 指定要使用的配置文件名稱（默認為 "default"）
• -m, --mode <mode>: 在“stdio”或“sse”模式之間選擇（默認為 "stdio"）
• --port <number>: 設置 SSE 模式的端口（默認為 3000）
• --host <host>: 設置 SSE 模式的主機（默認為 "localhost"）

獲取幫助：

node dist/server.js --help

工具命名規則

工具名稱會帶有其服務器名稱的前綴。例如：

• 來自“filesystem”服務器的工具“read_file”變為“filesystem_read_file”
• 來自“kubernetes”服務器的工具“get_pods”變為“kubernetes_get_pods”

SSE 模式端點

在 SSE 模式下，服務器暴露以下端點：

• GET /sse: 建立 SSE 連接
• POST /messages: 處理工具請求（需要提供sessionId查詢參數）

示例 SSE 客戶端用法：

const eventSource = new EventSource("http://localhost:3000/sse");
eventSource.onmessage = (event) => {
  console.log("接收:", event.data);
};

高級用法

配置文件

為每個配置文件創建名為 config.<profile>.json 的文件，例如：

// config.developer.json
{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }
  }
}

// config.personal.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/mirilale/Desktop"
      ]
    }
  }
}

📚 詳細文檔

錯誤處理

服務器提供詳細的錯誤信息，包括：

• 配置文件加載錯誤
• 服務器連接失敗
• 工具未找到錯誤
• 服務器斷開連接錯誤

所有錯誤消息都會包含當前配置文件名稱以提供更好的上下文。

開發

# 安裝依賴項
npm install

# 構建項目
npm run build

# 在開發模式下運行（stdio 模式）
npm run dev:stdio:developer
# 或者
npm run dev:sse:developer

# 使用 mpc 檢查工具
npm run inspect

📄 許可證

本項目採用 MIT 許可證。