跳转到内容

MCP (External Tools)

MCP tool server 配置位于 .openharness/tools/,采用目录式组织。

tools/
settings.yaml # Server 注册中心
servers/
docs-server/ # 本地代码型 server
package.json
index.js
browser/
package.json
server.py

声明当前 workspace 可见的 MCP servers:

docs-server:
command: node ./servers/docs-server/index.js
enabled: true
environment:
DOCS_TOKEN: ${secrets.DOCS_TOKEN}
timeout: 30000
expose:
tool_prefix: mcp.docs
include:
- search
- fetch
browser:
url: https://example.com/mcp
headers:
Authorization: Bearer ${secrets.BROWSER_TOKEN}
enabled: true
timeout: 30000
oauth: false
字段必填说明
顶层 key是Server 名称
command二选一本地进程型 server 启动命令
url二选一远程 server 地址
enabled否是否启用
environment否追加环境变量
headers否请求头(远程 server)
timeout否超时(毫秒)
expose否工具暴露策略(前缀、include/exclude)
oauth否是否使用 OAuth 认证

每个 server 必须声明 command 或 url,不可同时声明。

类型字段说明
本地 stdiocommand本地代码放 servers/<name>/
远程 httpurl可只在 settings.yaml 声明,无需本地目录

当 OAH 运行在 Docker 容器里,而 MCP Server 跑在宿主机本地时,127.0.0.1 / localhost 指向的是容器自身,不是宿主机。

现在对于 HTTP MCP server,OAH 在容器内会自动把下面这类地址:

  • http://127.0.0.1:PORT/...
  • http://localhost:PORT/...

改写为:

  • http://host.docker.internal:PORT/...

本地 docker-compose.local.yml 也已经为 OAH 容器补了 host.docker.internal:host-gateway 映射,因此在 Linux 上也能正常解析。

如果你的环境不使用 host.docker.internal,可以通过环境变量覆盖:

Terminal window
OAH_DOCKER_HOST_ALIAS=your-host-gateway-name

例如宿主机 MCP server 配置可以继续写成:

browser:
url: http://127.0.0.1:8789/mcp
enabled: true

当 OAH 运行在容器里时,它会自动转成可访问宿主机的地址。