如何集成容器运行时之外的MCP服务器

[ElinLiu0]

如图所示：

有鉴于MCP集成文档中给到的好像都是基于命令行启动的MCP服务器，也就是在Docker RT内部的，如果我在容器运行时之外启动了一个MCP服务器，那么这个时候应该如何集成到容器内你呢？

[WillemJiang]

DeerFlow 的 MCP 集成并不只支持 stdio(命令行子进程)这一种传输方式,它同时支持 sse 和 http(streamable HTTP) 两种远程传输——这两种都是通过 url 字段连接到一个已经在外部跑起来的 MCP 服务器,而不会在容器内启动子进程。所以「容器运行时之外启动的 MCP 服务器」正是 sse/http 类型的用途。

1. 在 extensions_config.json 里用 type: "http"(或 "sse")+ url

extensions_config.example.json 只给了 stdio 示例,但配置 schema(backend/packages/harness/deerflow/config/extensions_config.py)里 McpServerConfig.type 接受 stdio / sse / http 三种;sse 和 http 只需要 url(外加可选的 headers / oauth),不需要 command/args。

{
  "mcpServers": {
    "my-remote-mcp": {
      "enabled": true,
      "type": "http",
      "url": "http://host.docker.internal:8080/mcp",
      "headers": {
        "Authorization": "Bearer $MCP_TOKEN"
      },
      "description": "跑在宿主机上的 MCP 服务器(容器外)"
    }
  }
}

type 也可以写成 MCP 规范里的 transport(二者互为别名,type 优先)。这是专门修过的回归(对应 issue #3238):以前只用 transport: sse 会被误判成 stdio。

2. URL 里要用 host.docker.internal,而不是 localhost/127.0.0.1

容器里的 localhost 指的是容器自己,连不到宿主机。DeerFlow 的 docker/docker-compose.yaml 已经给 gateway 服务配好了:

extra_hosts:

• "host.docker.internal:host-gateway"

所以容器内直接用 http://host.docker.internal:<端口> 就能回连宿主机(这一项在 config.example.yaml 里也有说明:模型 base_url 在 Docker 部署时同样要改成 host.docker.internal)。NO_PROXY 也已经把 host.docker.internal 加进去了,不会走代理。

• Docker Desktop(Mac/Windows):host.docker.internal 开箱即用。
• Linux:靠 host-gateway 映射到 docker0 网关(如 172.17.0.1)。注意这种情况下,你那个 MCP 服务器要绑定到 0.0.0.0(或宿主机网卡 IP),不能只绑 127.0.0.1,否则容器还是连不上。为稳妥起见,建议无论哪个平台都让 MCP server 监听 0.0.0.0。
• 如果 MCP 服务器在另一台机器上:直接填那台机器的 IP / 域名即可(确保容器到该地址网络可达)。
• 如果它在同一个 compose 网络里的另一个容器:用服务名,例如 http://my-mcp:8080/mcp。

3. 几个补充

• 鉴权:远程服务器可用 headers(如上)或 oauth 字段(McpOAuthConfig,支持 client_credentials / refresh_token,自动刷新 token)。
• 超时:tool_call_timeout 只对 stdio 生效;sse/http 走传输层超时,配了也会被忽略并打日志。
• 如何让配置生效:extensions_config.json 是以只读卷挂进容器的(...:/app/backend/extensions_config.json:ro)。改完宿主机上的文件后,通过 Gateway API 触发 reload(或重启 gateway 容器)即可,不必重新构建镜像。
• 校验:type 写错或 sse/http 漏了 url,启动时会抛 requires 'url' field / unsupported transport type,日志里能看到。

一句话总结:把那个外部 MCP 服务器用 type: "http"(或 "sse")+ url 配进 extensions_config.json,URL 用 host.docker.internal:<端口> 指向宿主机(并确保该服务器监听 0.0.0.0),reload 配置即可,不需要把它搬进容器。

[ElinLiu0]

好的，我先把这个讨论留在这里，后续测试如果没有问题我会关掉。感谢回复🙏