MCP-Mirror注意：此项目处于积极开发中 (WIP)，API 可能发生变更。
概述
MCP 服务器运行器是一个 WebSocket 服务器实现，充当客户端与 模型上下文协议 (MCP) 服务器之间的桥梁。
前提条件
- Rust 1.70+
- MCP 服务器实现可执行文件
快速启动
1. 配置环境变量
# 必需配置
export PROGRAM=npx # MCP 服务器可执行文件路径
export ARGS=-y,@modelcontextprotocol/server-github # 以逗号分隔的参数
# 可选配置
export HOST=0.0.0.0 # 默认值
export PORT=8080 # 默认值
# MCP 服务器相关配置(示例)
export GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_***
2. 启动服务器
cargo run
或使用详细日志:
RUST_LOG=debug cargo run
3. 连接到 WebSocket
const ws = new WebSocket("ws://localhost:8080");
// 发送消息
ws.send(JSON.stringify({
// MCP 消息
}));
// 接收消息
ws.onmessage = (event) => {
const data = JSON.parse(event.data);
console.log(data);
};
Docker 部署
docker-compose up --build
主要特性
- WebSocket 服务器实现(单客户端)
- MCP 服务器进程管理
- 双向消息传递
- 优雅关闭处理
- 跨平台支持
限制
- 一次仅支持一个客户端连接
- 不支持内置 SSL/TLS (需使用反向代理)
- 没有内置身份验证机制