Openclaw MCP Bridge

openclaw mcp电桥

用于OpenClaw和其他MCP客户端的智能MCP桥。

该项目连接多个MCP服务器，并通过一个接口公开它们，具有相关性过滤和可选缓存功能。

项目状态

此包目前尚未发布到npm。 通过克隆此存储库在本地使用它。

快速入门（本地）

先决条件

• Node.js 20.19+ （推荐）
• pnpm
• OpenClaw（仅当你想要插件模式时）

克隆和构建

git clone https://github.com/gabrielekarra/openclaw-mcp-bridge.git
cd openclaw-mcp-bridge
pnpm install
pnpm build

使用模式

1.OpenClaw插件（本地）

从本地存储库安装插件：

openclaw plugins install .
openclaw gateway restart

在中启用/配置它 ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "mcp-bridge": {
        "enabled": true,
        "config": {
          "autoDiscover": true
        }
      }
    }
  }
}

笔记：

• 插件密钥必须为 mcp-bridge （比赛 openclaw.plugin.json).
• 随着 autoDiscover: true，它从以下位置读取MCP服务器 ~/.mcp.json.

2.独立MCP服务器

直接运行网桥服务器：

pnpm start -- --config ./examples/bridge-config.json

您也可以直接使用Node运行它：

node dist/server/index.js --config ./examples/bridge-config.json

对于Claude Desktop，请将此添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "bridge": {
      "command": "node",
      "args": [
        "/absolute/path/to/openclaw-mcp-bridge/dist/server/index.js",
        "--config",
        "/absolute/path/to/openclaw-mcp-bridge/examples/bridge-config.json"
      ]
    }
  }
}

操作模式

网桥支持两种操作模式（OpenClaw插件模式和独立MCP服务器模式），由一个配置键控制：

{
  "mode": "smart"
}

• smart （默认，原始设计）：使用相关性分析、排名、阈值和可选缓存。
• traditional：在启动时注册所有发现的MCP工具，不进行相关性过滤或延迟工具激活。

迁移说明：

• 如果您希望所有MCP工具始终可见，请使用 mode: traditional.

智能模式示例（默认）

{
  "plugins": {
    "entries": {
      "mcp-bridge": {
        "enabled": true,
        "config": {
          "mode": "smart",
          "autoDiscover": true
        }
      }
    }
  }
}

传统模式示例

{
  "plugins": {
    "entries": {
      "mcp-bridge": {
        "enabled": true,
        "config": {
          "mode": "traditional",
          "autoDiscover": true
        }
      }
    }
  }
}

独立模式示例

examples/bridge-config.json 形状：

{
  "mode": "smart",
  "autoDiscover": true
}

{
  "mode": "traditional",
  "autoDiscover": true
}

已注册工具（插件模式）

智能模式工具

mcp_find_tools

从连接的MCP服务器中查找可用工具。

示例：

• “查找创建GitHub问题的工具”
• “Notion有哪些可用工具？”
• “列出所有MCP工具”

行为：

• 如果 need 如果存在，则按相关性对工具进行排名。
• 如果 need 如果为空/缺失，则返回可用工具（为可读性而设上限）。
• 结果包括 server + name 使用的值 mcp_call_tool.

mcp_call_tool

调用由返回的下游工具 mcp_find_tools.

必需参数：

• server （字符串）
• tool （字符串）

可选参数：

• arguments （对象）

示例呼叫有效载荷：

{
  "server": "notion",
  "tool": "create_page",
  "arguments": {
    "title": "Roadmap"
  }
}

mcp_list_servers

列出已配置的MCP服务器及其发现的工具计数。

示例：

• “连接了哪些MCP服务器？”
• “显示可用服务器”

传统模式工具

• 在启动时注册每个发现的MCP工具。
• 工具名称的命名空间为 mcp__.
• 每个注册的工具直接调用其底层MCP服务器工具。

独立行为总结：

• mode: smart 暴露 find_tools 加上压缩的下游工具条目。
• mode: traditional 仅公开命名空间的下游工具（否 find_tools 元工具）。

流程是如何工作的

1. 用户要求执行可能需要外部工具的任务。
2. 客服电话 mcp_find_tools.
3. Bridge在MCP服务器上发现工具并对匹配进行排名。
4. 客服电话 mcp_call_tool 与所选 server + tool.
5. 网桥将呼叫路由到正确的MCP服务器。

配置

自动发现来自 ~/.mcp.json

启用后，网桥从以下位置导入服务器 ~/.mcp.json.

例子：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/mcp-server"]
    }
  }
}

显式服务器配置

您可以提供 servers 在插件配置中明确：

{
  "plugins": {
    "entries": {
      "mcp-bridge": {
        "enabled": true,
        "config": {
          "autoDiscover": false,
          "servers": [
            {
              "name": "github",
              "transport": "stdio",
              "command": "npx",
              "args": ["-y", "@modelcontextprotocol/server-github"],
              "categories": ["code", "issues", "repos"]
            }
          ]
        }
      }
    }
  }
}

看 examples/ 用于即用型配置。

独立注释：

• loadConfig() 接受两种独立的桥梁形状({ mode, servers, ... })和OpenClaw插件形状(plugins.entries["mcp-bridge"].config).

配置参考

发展

pnpm install
pnpm build
pnpm test
pnpm lint

故障排除

许可证

麻省理工学院

学分

• 开爪 --最佳个人AI代理
• mcp使用 --为我们的连接提供动力的MCP框架
• 模型上下文协议 --使这成为可能的标准