MCP Server Runner

🚀 MCP 服務器運行器

一個用於運行 模型上下文協議 (MCP) 服務器的 WebSocket 服務器實現。此應用程序藉助 WebSocket 連接讓 MCP 服務器得以被訪問，進而實現與網絡客戶端（包括 Web 應用程序）的集成。

⚠️ 重要提示

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

🚀 快速開始

先決條件

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

配置

環境變量

該應用程序可通過環境變量進行配置：

PROGRAM=        # MCP 服務器可執行文件的路徑（必需，如果未指定配置文件）
ARGS=           # 傳遞給 MCP 服務器的參數
HOST=           # 監聽的主機地址，默認為 0.0.0.0
PORT=           # 監聽的端口號，默認為 3000

配置文件

可以通過以下命令生成默認配置文件：

mcp-server-runner init-config > config.yml

使用說明

環境變量配置示例

export PROGRAM=/path/to/mcp-server
export ARGS=--some-argument
export HOST=127.0.0.1
export PORT=8080

啟動服務器：

mcp-server-runner start

命令行配置示例

mcp-server-runner --program /path/to/mcp-server --args --some-argument --host 127.0.0.1 --port 8080 start

✨ 主要特性

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

📚 詳細文檔

開發狀態

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

概述

MCP 服務器運行器充當 WebSocket 客戶端與 MCP 服務器實現之間的橋樑。它：

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

架構

MCP 服務器運行器由以下幾個主要模塊組成：

• main.rs：程序的入口點
• config/：配置相關的實現
• server/：WebSocket 服務器的核心邏輯
• logger/：日誌記錄和錯誤處理

錯誤處理

錯誤類型

• ConfigurationError：配置相關錯誤
• ConnectionError：連接相關錯誤
• ProtocolError：協議相關錯誤

已知限制

• 當前版本僅支持單個客戶端連接
• 不支持 WebSocket 協議的壓縮和代理
• 未實現完整的 MCP 協議規範

貢獻指南

如何貢獻

1. 克隆倉庫

git clone git@github.com:your-repository.git

2. 創建功能分支

git checkout -b feature/your-feature-name

3. 提交更改

git commit -m '添加 awesome 功能'

4. 推送到遠程倉庫

git push origin feature/your-feature-name

5. 創建拉取請求 通過 GitHub Pull Request 提交您的更改。

📄 許可證

此項目根據 MIT 許可證發佈，具體內容請參閱 LICENSE 文件。

🔗 額外資源

• 模型上下文協議規範
• WebSocket 協議 (RFC 6455)