Yonaka15 MCP Server Runner

🚀 MCP 服務器運行器

MCP 服務器運行器是一個用於運行 Model Context Protocol (MCP) 服務器的 WebSocket 服務器實現。它能讓 MCP 服務器通過 WebSocket 連接被訪問，極大地促進了與網絡客戶端和 Web 應用程序的集成。

⚠️ 重要提示

該項目目前處於積極開發階段，並且是 WIP（未完成）狀態。功能和 API 可能會發生顯著變化。

🚀 快速開始

先決條件

• Rust 1.70 或更高版本
• MCP 服務器實現可執行文件

配置

通過環境變量配置應用程序：

PROGRAM=        # MCP 服務器可執行文件的路徑（必需）
ARGS=           # MCP 服務器的參數，以逗號分隔的列表
HOST=0.0.0.0    # 綁定到的主機地址（默認：0.0.0.0）
PORT=8080       # 監聽的端口（默認：8080）

其他環境變量將傳遞給 MCP 服務器進程。

使用步驟

1. 設置環境變量：

export PROGRAM=npx
export ARGS=-y,@modelcontextprotocol/server-github
export PORT=8080
export GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_***

2. 運行服務器：

cargo run

3. 連接到 WebSocket 服務器：

const ws = new WebSocket("ws://localhost:8080");

Docker 支持

提供 Dockerfile 和 docker-compose.yml 用於容器化部署：

docker-compose up --build

✨ 主要特性

• 具有單客戶端支持的 WebSocket 服務器實現
• MCP 服務器實例的過程管理
• 客戶端與服務器之間的雙向消息傳遞
• 優雅關閉處理
• 全面錯誤記錄
• 跨平臺支持（Unix/Windows）

📚 詳細文檔

概述

MCP 服務器運行器充當 WebSocket 客戶端與 MCP 服務器實現之間的橋樑。它具備以下功能：

• 啟動 MCP 服務器進程
• 管理 WebSocket 連接
• 處理客戶端和服務器之間的雙向通信
• 支持優雅關閉和錯誤處理

開發狀態

• 🚧 進行中：該軟件正在積極開發
• ⚠️ API 穩定性：API 和功能可能會發生變化，恕不另行通知
• 🧪 測試：目前正在進行測試和改進
• 📝 文檔：文檔正在積極更新

架構

應用程序遵循模塊化架構：

• main.rs：應用程序入口點和服務器設置
• process/：進程管理和 I/O 處理
• websocket/：WebSocket 連接管理
• state.rs：全局狀態管理
• shutdown.rs：優雅關閉處理

錯誤處理

• 標準錯誤輸出從 MCP 服務器記錄但不轉發給客戶端
• WebSocket 連接錯誤會得到優雅處理
• 進程錯誤會詳細記錄

侷限性

• 只支持一個客戶端連接
• 不支持 WebSocket SSL/TLS（請使用反向代理進行安全連接）
• 沒有內置的身份驗證機制

貢獻

1. 分叉倉庫
2. 創建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打開 Pull Request

📄 許可證

該項目遵循 MIT 許可證，詳情請見 LICENSE 文件。

額外資源

• Model Context Protocol 規範
• WebSocket 協議 (RFC 6455)