
MCP Server Runner

2024.12.27
0
RustWebSocket 服务器MCP 服务器其它
MCP Server Runner 是一个用于运行 Model Context Protocol (MCP) 服务器的 WebSocket 服务器实现。它充当 WebSocket 客户端和 MCP 服务器实现之间的桥梁,支持通过 WebSocket 连接访问 MCP 服务器,便于与 Web 应用程序和其他网络客户端集成。
View on GitHub
Overview
基本能力
产品定位
MCP Server Runner 是一个 WebSocket 服务器实现,用于运行 Model Context Protocol (MCP) 服务器,支持通过 WebSocket 连接访问 MCP 服务器,便于与 Web 应用程序和其他网络客户端集成。
核心功能
- WebSocket 服务器实现,支持单客户端连接
- MCP 服务器实例的进程管理
- 客户端和服务器之间的双向消息传递
- 优雅的关闭处理
- 全面的错误日志记录
- 跨平台支持(Unix/Windows)
适用场景
- 需要将 MCP 服务器集成到 Web 应用程序中的场景
- 需要通过 WebSocket 连接访问 MCP 服务器的场景
- 需要跨平台运行 MCP 服务器的场景
工具列表
cargo
: Rust 的包管理器和构建工具,用于构建和运行项目docker
: 容器化部署工具,用于构建和运行 Docker 容器docker-compose
: 容器编排工具,用于管理多个容器的部署
常见问题解答
- Q: 是否支持多客户端连接? A: 目前仅支持单客户端连接。
- Q: 是否支持 SSL/TLS? A: 不支持,建议使用反向代理实现安全连接。
- Q: 是否有内置的身份验证机制? A: 没有内置的身份验证机制。
使用教程
使用依赖
- Rust 1.70 或更高版本
- MCP 服务器实现的可执行文件
安装教程
- 设置环境变量:
bash export PROGRAM=npx export ARGS=-y,@modelcontextprotocol/server-github export PORT=8080 export GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_***
- 运行服务器:
bash cargo run
- 连接到 WebSocket 服务器:
javascript const ws = new WebSocket("ws://localhost:8080");
调试方式
- 运行测试:
bash cargo test
- 使用调试日志运行:
bash RUST_LOG=debug cargo run
- 使用 Docker 运行:
bash docker-compose up --build