Cherry Mcp

🍒 MCP服务的HTTP持久化桥接器

HTTP桥接器让MCP服务持久运行,通过REST API暴露工具能力,解决stdio进程易断连痛点

收藏
10.1k
安装
2.3k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Cherry MCP 是一款专为 Model Context Protocol (MCP) 服务器设计的 HTTP 桥接工具。其核心功能是将原本依赖 stdio 通信的 MCP 服务器转换为持久的 HTTP 服务:首先通过 CLI 添加服务器配置(add-server),设置环境变量后启动桥接守护进程,即可通过 REST API 调用任意 MCP 工具。

典型工作流:
1. node cli.js add-server github npx @anthropic/mcp-github 注册服务器

2. node cli.js set-env github GITHUB_TOKEN xxx 配置凭证

3. pm2 start bridge.js 启动持久化桥接

4. curl http://localhost:3456/github/call 通过 HTTP 调用工具

显著优点

  • 进程保活机制:自动重启崩溃的 MCP 服务器,彻底解决 stdio 进程"无人值守即死亡"的核心痛点
  • 零侵入改造:无需修改 MCP 服务器代码,纯外部桥接方案
  • 多服务器聚合:单一桥接实例可同时管理多个异构 MCP 服务
  • 生产级运维:内置 PM2 集成,支持开机自启、日志管理、进程监控
  • 安全基线:默认仅绑定 127.0.0.1,提供速率限制、IP 白名单、审计日志三重防护

潜在局限

  • 凭证管理风险:set-env 将密钥明文写入 config.json,需配合 .gitignore 或改用 shell 环境变量
  • 单点故障:桥接器本身成为关键依赖,其崩溃会导致所有托管 MCP 服务失联
  • 协议转换损耗:stdio↔HTTP 转换引入额外延迟,高频调用场景需压测验证
  • Node.js 依赖:需维护 Node 运行时环境,增加部署复杂度

适合人群

  • 需要将 MCP 工具集成至不支持 stdio 的 AI 客户端(如 OpenClaw)的开发者
  • 追求 MCP 服务器"常驻后台、随调随用"体验的生产环境用户
  • 熟悉 Node.js/PM2 生态、具备基础网络安全意识的技术团队

常规风险

  • 配置泄露:config.json 若未妥善保管,可能导致 API 密钥泄露
  • 本地提权:绑定 localhost 虽阻断外网,但本机恶意进程仍可访问
  • 资源耗尽:未设置速率限制时,批量工具调用可能打满系统资源

Cherry Mcp 内容

手动下载zip · 6.3 kB
bridge.jstext/javascript
请选择文件