MCP Gateway

统一 MCP 工具网关 — Agent 通过它访问 WebPilot 浏览器工具及其他后端能力 给 Agent 用的 Electron 托盘应用

快速开始

# 1. 安装依赖
cd "C:\Users\13952\Desktop\cursor 工作\mcp-gateway"
npm install

# 2. 启动 Electron 托盘应用
npm run electron

启动后：

• 系统托盘中出现 MCP Gateway 图标
• Agent 可通过 http://127.0.0.1:9223/mcp 连接
• 如果 WebPilot 项目已安装依赖，Gateway 会自动拉起它并暴露 79 个浏览器工具

架构

Agent (oh-agent-company 角色)
  │ MCP 协议 (tools/list, tools/call)
  ▼
MCP Gateway (:9223)
  ├── Registry (工具注册表)
  ├── WebPilot Bridge → WebPilot daemon (:9224 MCP / :9225 HTTP) → Chrome (:9222 CDP)
  └── [可插拔] 其他后端

端口

端口	服务	说明
9223	Gateway MCP	Agent 连接端点
9224	WebPilot MCP	WebPilot 内部 MCP (由 Gateway 管理)
9225	WebPilot HTTP	WebPilot HTTP API (由 Gateway 代理)

目录结构

mcp-gateway/
├── package.json
├── electron/
│   └── main.cjs        # Electron 主进程 (单实例锁 + 托盘 + 启动 Gateway)
├── src/
│   ├── server.js        # MCP Gateway 核心 (StreamableHTTP Server)
│   ├── registry.js      # 工具注册表
│   └── webpilot-bridge.js # WebPilot 子进程管理 + 工具代理
└── resources/

健康检查

curl http://127.0.0.1:9223/health
# => { "status": "ok", "backends": [...], "toolCount": 79 }

开发

# 独立运行 (不带 Electron 托盘)
node src/server.js

# 环境变量
GATEWAY_PORT=9223       # Gateway 监听端口

前置要求

• Node.js >= 22
• WebPilot-v4.0.1-handoff 项目 (npm install 在该目录下也需执行)
• Chrome (需开启 --remote-debugging-port=9222)

与 oh-agent-company 的集成

已更新的角色 (可使用 WebPilot MCP 工具):

角色	事业部	用途
web-tester	02-科技与工程	浏览器自动化测试
qa-engineer	02-科技与工程	bug 复现、回归测试
security-auditor	02-科技与工程	客户端安全扫描
market-researcher	01-经济与产业	在线竞品调研
deep-researcher	13-基础学科与人类科学	多源在线检索
academic-researcher	03-教育与学术	学术数据库检索

详见 ../oh-agent-company/oh-agent-company/共享/场景模板/09-浏览器自动化测试.md