MCP Remote Server

🚀 mcp-遠程服務器

mcp-遠程服務器是一個可配置的模型上下文協議（MCP）服務器，其能力可通過遠程配置動態加載。它藉助模型上下文協議創建本地服務器，實現與本地MCP客戶端的通信，為用戶提供靈活、高效的服務。

🚀 快速開始

mcp-遠程服務器充當MCP客戶端和遠程API之間的橋樑。它會解析一個遠程託管的配置（通過MCP_CONTROL_PLANE_URL指定），該配置包含工具、資源和提示的列表，每個都指向遠程API端點。

✨ 主要特性

• 動態配置：服務器的功能由遠程JSON配置定義。
• 自動刷新：配置每60秒自動刷新一次。
• 支持所有MCP原語：
  • 工具：通過遠程API調用執行操作。
  • 資源：將遠程數據作為可讀資源暴露。
  • 提示：定義可重用的提示模板。

📦 安裝指南

bun install

💻 使用示例

基礎用法

1. 設置您的控制平面URL：

export MCP_CONTROL_PLANE_URL="https://your-config-endpoint"

2. 運行服務器：

bun run index.ts

📚 詳細文檔

配置格式

{
  "tools": [{
    "name": "tool-name",
    "description": "工具描述",
    "inputSchema": {
      "type": "object",
      "properties": {
        // JSON Schema用於工具輸入
      }
    },
    "handler": "https://api.example.com/tool-endpoint"
  }],
  "resources": [{
    "uri": "resource://identifier",
    "name": "資源名稱",
    "description": "資源描述",
    "mimeType": "application/json",
    "handler": "https://api.example.com/resource-endpoint"
  }],
  "prompts": [{
    "name": "prompt-name",
    "description": "提示描述",
    "arguments": [{
      "name": "arg-name",
      "description": "參數描述",
      "required": true
    }],
    "handler": "https://api.example.com/prompt-endpoint"
  }]
}

處理程序API要求

遠程處理程序必須返回適當格式的響應：

• 工具處理程序：返回JSON，該JSON將被字符串化幷包裝在MCP工具響應中。
• 資源處理程序：返回與指定 mimeType匹配的內容。
• 提示處理程序：返回字符串（自動包裝在消息中）或MCP格式的消息數組。

侷限性

• 只支持HTTP/HTTPS處理程序端點。
• 配置必須可通過HTTP GET請求訪問。
• 處理程序響應必須是JSON兼容的。
• 僅在本地運行（標準MCP限制）。

項目相關信息

此項目使用bun init創建，版本為bun v1.1.32。Bun是一個快速的一站式JavaScript運行時。選擇Bun是因為它速度快，而且想嘗試一些不同的東西。

該項目還使用Biome進行類型檢查和代碼格式化。選擇Biome的原因與選擇Bun相同，希望能為JS有一個類似gofmt的工具，這是一個很好的開始。