MCP Server Runner

MCP Server Runner

site icon
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 服务器实现的可执行文件

安装教程

  1. 设置环境变量: bash export PROGRAM=npx export ARGS=-y,@modelcontextprotocol/server-github export PORT=8080 export GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_***
  2. 运行服务器: bash cargo run
  3. 连接到 WebSocket 服务器: javascript const ws = new WebSocket("ws://localhost:8080");

调试方式

  • 运行测试: bash cargo test
  • 使用调试日志运行: bash RUST_LOG=debug cargo run
  • 使用 Docker 运行: bash docker-compose up --build

许可证

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