MCP多路复用器

一个连接上游MCP服务器并通过单一`sandbox_eval_js`工具统一编排和执行所有工具的MCP多路复用器,支持Node.js和Deno运行环境。

  • by ruifung
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ruifung/mcp-cm-bridge

使用说明

代码模式桥

MCP(模型上下文协议)多路复用器,连接到上游MCP服务器,并通过单个 sandbox_eval_js 用于统一编排和执行的工具。继续运行 Node.js 和 迪诺.Bun不受官方支持——如果你需要使用Bun,请确保容器运行时(Docker或Podman)或Deno在你的PATH中可用,这样桥就可以将代码执行委托给受支持的执行器。

主要特点

  • 多服务器桥接:同时连接到多个上游MCP服务器。
  • 工具聚合:通过单一界面展示所有上游功能 sandbox_eval_js 工具。
  • 动态发现:三个内置的发现工具让代理在编写代码之前找到并检查可用的函数。
  • 多执行器沙盒:通过Deno、隔离vm、Docker/Podman容器或vm2安全执行。
  • 自动检测:自动为您的环境选择最佳可用执行器。
  • 实时重新加载:手表 mcp.json 用于更改和热重新加载上游连接,而无需重新启动。
  • CLI管理:用于服务器配置的简单命令行界面。

快速开始

安装与运行

# Run without installing
npx @ruifung/codemode-bridge

# Or install globally
npm install -g @ruifung/codemode-bridge
codemode-bridge run

基本用法

  1. 添加服务器:
    codemode-bridge config add kubernetes --type stdio --command "npx" --args "-y,kubernetes-mcp-server@latest"
    
  2. 启动桥梁:
    codemode-bridge run
    
  3. 在您的客户中使用:将您的MCP客户端(Claude Desktop、VS Code等)指向 npx @ruifung/codemode-bridge.

发现工具

这座桥展示了三种工具,用于在写作前发现可用的内容 sandbox_eval_js 代码:

工具 说明
sandbox_get_functions 列出按服务器分组的所有可用功能。接受可选 server 过滤器。
sandbox_get_function_schema 按名称获取特定函数的TypeScript类型定义。
sandbox_search_functions 关键字搜索所有函数名称和描述。返回与其模式匹配的函数。

打电话前使用这些 sandbox_eval_js 找到正确的函数名和参数类型。

使用 sandbox_eval_js 工具

这 sandbox_eval_js 该工具在沙盒环境中执行JavaScript,并通过 codemode 对象。你可以编写一个函数体或一个完整的异步箭头函数:

// Function body (auto-wrapped):
const result = await codemode.server_name__function_name({ param: "value" });
return result;

// Or as a complete async arrow function:
async () => {
  const result = await codemode.server_name__function_name({ param: "value" });
  return result;
}

文档索引

  • 建筑桥梁的工作原理、项目结构和逻辑流程。
  • 执行器:沙箱后端(Deno、隔离vm、容器)的详细比较。
  • CLI和配置:完整的命令参考和配置格式。
  • HTTP服务模式:多客户端HTTP传输、会话隔离和安全。
  • 集成指南:Claude Desktop、VS Code等的安装说明。
  • 发展:为贡献者提供构建和测试说明。
  • 砂箱硬化:执行环境的安全细节。