Pluggedin MCP Proxy

🚀 plugged.in 模型上下文協議（MCP）代理服務器

本項目旨在為模型上下文協議（Model Context Protocol, MCP）客戶端提供服務。該代理服務器可連接多個底層MCP服務器，並通過統一接口將其能力（工具、資源、提示等）提供給上層應用。

🚀 快速開始

此項目是“plugged.in MCP Proxy Server”，為MCP客戶端服務，連接多個底層MCP服務器，通過統一接口暴露能力。

📦 安裝指南

1. 安裝依賴項

安裝 Node.js

建議使用Node.js 16或更高版本，可通過以下命令安裝：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
nvm install --lts

安裝npm包

npm install -g npm@latest

安裝項目依賴

進入項目目錄後運行：

npm install

2. 運行服務器

使用以下命令啟動代理服務器：

node index.js

後續操作

啟動開發服務器

npm run dev

構建項目

npm run build

運行測試

npm test

🔧 技術細節

系統架構

該代理服務器充當MCP客戶端（如Claude Desktop）和多個底層MCP服務器之間的橋樑。

工作流程

1. 配置獲取：代理服務器從plugged.in應用獲取服務器配置。
2. 能力列表：
   • tools/list：通過/api/tools接口獲取工具列表（帶前綴）
   • resources/list：通過/api/resources接口獲取資源列表
   • resource-templates/list：通過/api/resource-templates接口獲取資源模板列表
   • prompts/list：合併來自/api/prompts和/api/custom-instructions的結果，返回提示詞列表
3. 能力解析：
   • tools/call：從工具名稱中提取前綴，查找目標服務器
   • resources/read：調用/api/resolve/resource?uri=...接口獲取服務器詳細信息
   • prompts/get：檢查是否有自定義指令前綴或調用/api/resolve/prompt?name=...接口
4. 請求路由：將請求轉發到相應的底層MCP服務器
5. 響應處理：將來自底層服務器的響應返回給客戶端

📚 詳細文檔

與plugged.in 應用集成

該代理服務器設計用於與plugged.in 應用無縫協作，提供以下功能：

• 集中式能力發現（工具、資源、模板、提示）
• 自定義指令管理
• 多工作區支持以維護不同配置集
• 交互式控制檯用於測試MCP工具
• 用戶身份驗證和API密鑰管理

相關資源

• plugged.in 應用倉庫
• 模型上下文協議（MCP）規範
• Claude Desktop 文檔
• Cline 文檔

項目結構

• index.js：主入口文件，啟動代理服務器。
• config/：包含配置文件和環境變量設置。
• routes/：定義各種HTTP路由處理邏輯。
• middleware/：實現請求處理的中間件功能。
• utils/：提供輔助函數和工具方法。

貢獻指南

1. 克隆倉庫

   git clone https://github.com/yourusername/pluggedin-mcp-proxy.git
   cd pluggedin-mcp-proxy
   

2. 安裝依賴

   npm install
   

3. 啟動開發環境

   npm run dev
   

4. 開始編碼：

   • 查看項目結構，熟悉代碼組織。
   • 針對具體功能模塊進行開發或修復問題。

5. 提交更改

   • 完成修改後，添加變更記錄：

     git add .
     git commit -m "你的提交信息"
     

   • 推送到遠程倉庫：

     git push origin your-branch-name
     

6. 創建Pull Request：

   • 在GitHub上為項目新建一個Pull Request，詳細說明你所做的修改及其目的。

問題反饋

如遇任何問題或有改進建議，請訪問Issues頁面提交Issue。

📄 許可證

本項目的授權遵循MIT LICENSE。