Remote MCP

🚀 遠程-MCP 項目文檔

遠程-MCP 是一個遠程模型上下文協議的解決方案，可實現遠程訪問和集中管理模型上下文，為模型上下文協議提供了強大的擴展能力。

🚀 快速開始

客戶端配置

1. 安裝客戶端包：

   npm install @remote-mcp/client
   

2. 創建本地 MCP 服務：

   import { MCPRouter, LogLevel } from "@remote-mcp/client";
   
   const mcpRouter = new MCPRouter({
     logLevel: LogLevel.DEBUG,
     name: "example-client",
     version: "1.0.0",
   });
   
   // 添加自定義工具或命令
   mcpRouter.addTool(
     "calculator",
     {
       description: "Perform basic calculations.",
       schema: z.object({
         operation: z.enum(["add", "subtract", "multiply", "divide"]),
         a: z.string(),
         b: z.string(),
       }),
     },
     async (args) => {
       // 處理計算邏輯
       return {
         content: [{ type: "text", text: `${result}` }],
       };
     }
   );
   
   // 啟動服務
   mcpRouter.listen(9512);
   

服務端實現

1. 安裝服務器包：

   npm install @remote-mcp/server
   

2. 創建遠程 MCP 服務：

   import { MCPRouter, LogLevel } from "@remote-mcp/server";
   import { createHTTPServer } from '@trpc/server/adapters/standalone';
   
   const mcpRouter = new MCPRouter({
     logLevel: LogLevel.DEBUG,
     name: "example-server",
     version: "1.0.0",
     capabilities: {
       logging: {},
     },
   });
   
   // 添加示例工具
   mcpRouter.addTool(
     "calculator",
     {
       description:
         "Perform basic calculations. Add, subtract, multiply, divide.",
       schema: z.object({
         operation: z.enum(["add", "subtract", "multiply", "divide"]),
         a: z.string(),
         b: z.string(),
       }),
     },
     async (args) => {
       const a = Number(args.a);
       const b = Number(args.b);
   
       switch (args.operation) {
         case "add":
           return { content: [{ type: "text", text: `${a + b}` }] };
         case "subtract":
           return { content: [{ type: "text", text: `${a - b}` }] };
         // 其他操作...
       }
     }
   );
   
   // 啟動 HTTP 服務
   createHTTPServer({
     router: mcpRouter,
   }).start({ port: 9512 });
   

✨ 主要特性

核心組件

• @remote-mcp/client：客戶端庫，作為本地 MCP 服務運行，連接到遠程實現。
• @remote-mcp/server：服務器端庫，用於創建可遠程訪問的 MCP 服務。

功能特點

• 基本的類型安全客戶端/服務器通信。
• 支持基本的 MCP 命令、工具和提示功能。
• 提供 HTTP 頭部支持（包括自定義頭部和身份驗證中間件）。
• 初步的錯誤處理改進和基礎中間件支持。

示例架構

以下是遠程-MCP 的示例架構圖：

📚 詳細文檔

為什麼現在需要這個庫？

當前的 MCP 實現僅限於本地使用，無法滿足遠程訪問和集中管理的需求。遠程-MCP 解決了這一痛點，為模型上下文協議提供了擴展能力，支持更多高級功能。

已有的包依賴

• @remote-mcp/client：用於客戶端通信。
• @remote-mcp/server：用於服務器端實現。
• trpc：支持基於 TRPC 的遠程過程調用。

未來的發展路線圖

計劃功能

1. 完善錯誤處理：改進錯誤處理機制，提升用戶體驗。
2. 支持更多協議：擴展對更多通信協議的支持。
3. 增強安全性：增加更多的安全特性，如 SSL 支持和令牌驗證。

如何貢獻？

歡迎社區成員參與項目！

• 提交問題報告：GitHub Issues
• 提交代碼修復或新功能：Pull Request

免責聲明

本項目僅為實驗性質，不適用於生產環境。使用前請仔細閱讀文檔並確保充分測試。

參考資料

1. MCP 協議文檔：鏈接
2. TRPC 文檔：鏈接

📄 許可證

項目遵循 MIT 許可證，具體條款詳見 LICENSE 文件。