MCP Server Runner

基本能力

产品定位

MCP Server Runner 是一个 WebSocket 服务器实现，用于运行 Model Context Protocol (MCP) 服务器，充当 WebSocket 客户端和 MCP 服务器之间的桥梁。

核心功能

• WebSocket 服务器实现（单客户端支持）
• MCP 服务器实例的进程管理
• 客户端和服务器之间的双向消息传递
• 优雅的关闭处理
• 全面的错误日志记录
• 跨平台支持（Unix/Windows）

适用场景

• 需要将 MCP 服务器集成到 Web 应用程序中的场景
• 需要通过网络连接访问 MCP 服务器的场景
• 需要双向通信的 MCP 服务器应用

工具列表

• cargo: Rust 的包管理器和构建工具，用于构建和运行项目
• docker: 容器化部署工具，用于构建和运行 Docker 容器
• docker-compose: 用于定义和运行多容器 Docker 应用程序的工具

常见问题解答

• API 稳定性: API 和功能可能会在没有通知的情况下更改
• 测试状态: 目前正在进行测试和优化
• 文档状态: 文档正在积极更新中
• 限制: 仅支持一个客户端连接，不支持 WebSocket SSL/TLS，无内置认证机制

使用教程

使用依赖

• Rust 1.70 或更高版本
• MCP 服务器实现的可执行文件

安装教程

1. 使用环境变量安装: bash export PROGRAM=npx export ARGS=-y,@modelcontextprotocol/server-github export PORT=8080 export GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_*** cargo run

2. 使用配置文件安装: ```bash # 指定配置文件作为参数 cargo run config.json

# 或使用 CONFIG_FILE 环境变量 CONFIG_FILE=config.json cargo run ```

1. 连接到 WebSocket 服务器: javascript const ws = new WebSocket("ws://localhost:8080");

调试方式

• 构建项目: bash cargo build

• 运行测试: bash cargo test

• 使用调试日志运行: bash RUST_LOG=debug cargo run

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。