From 6fff0dd936ce542c7d542c980c73d384e1aa8fa1 Mon Sep 17 00:00:00 2001 From: root Date: Tue, 15 Sep 2026 22:23:39 +0800 Subject: [PATCH] =?UTF-8?q?=E7=BD=91=E7=BB=9C=E6=94=B9=E5=90=8D=EF=BC=9Amy?= =?UTF-8?q?-app-network=20=E2=86=92=20agent-mcp-net=EF=BC=88=E4=B8=8E=20ag?= =?UTF-8?q?ent=20=E4=BE=A7=E4=B8=80=E8=87=B4=EF=BC=8C=E7=BA=AF=E6=94=B9?= =?UTF-8?q?=E5=90=8D=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- mcp/README.md | 8 ++++---- mcp/docker-compose.yml | 10 +++++----- mcp/image_gen/README.md | 2 +- mcp/video_gen/Dockerfile | 2 +- mcp/video_gen/README.md | 4 ++-- mcp/web_search/README.md | 2 +- 6 files changed, 14 insertions(+), 14 deletions(-) diff --git a/mcp/README.md b/mcp/README.md index e0f88e5..c878093 100644 --- a/mcp/README.md +++ b/mcp/README.md @@ -8,23 +8,23 @@ | `image_gen/` | `mcp_image_gen` | 智谱 CogView 图片生成 | `3000` | `POST /mcp` | | `video_gen/` | `mcp_video_gen` | 智谱 CogVideo 视频生成(异步) | `3000` | `POST /mcp` | -**这些服务一个宿主机端口都不占**——它们只挂在 `my-app-network` 上,由 `agent-core` / `agent-executor` +**这些服务一个宿主机端口都不占**——它们只挂在 `agent-mcp-net` 上,由 `agent-core` / `agent-executor` 按容器名访问。所以整台服务器对外只需要开 agent-core 那一个端口(`AGENT_PORT`,默认 8090)。 (要从宿主机 curl 调试时,把 `docker-compose.yml` 里对应服务注释掉的 `ports` 两行打开。) ## 部署(无 nginx-proxy) -网络 `my-app-network` 由 **agent 的 compose 创建**,所以全新机器上必须先起一次 agent: +网络 `agent-mcp-net` 由 **agent 的 compose 创建**,所以全新机器上必须先起一次 agent: ```bash -# 1) 先起 agent(它会创建 my-app-network;首次还要先备好 config.yml 与 .env) +# 1) 先起 agent(它会创建 agent-mcp-net;首次还要先备好 config.yml 与 .env) cd /root/workspace/tools/agent && docker compose up -d --build # 2) 再起 mcp cd /root/workspace/tools/mcp && docker compose up -d --build ``` -> mcp 单独在一个没有该网络的机器上先起会报错(`network my-app-network declared as external, but could not be found`),这是预期行为。 +> mcp 单独在一个没有该网络的机器上先起会报错(`network agent-mcp-net declared as external, but could not be found`),这是预期行为。 > 拆的时候反着来(先 down mcp 再 down agent)。 `image_gen` / `video_gen` 需要智谱 token,但 token **不由服务端保存**——每个请求从 header 读取 diff --git a/mcp/docker-compose.yml b/mcp/docker-compose.yml index d39245c..bbfd304 100644 --- a/mcp/docker-compose.yml +++ b/mcp/docker-compose.yml @@ -1,4 +1,4 @@ -# 无 nginx-proxy 部署:这些服务**默认不占宿主机端口**,只挂在 my-app-network 上被 agent 按容器名访问。 +# 无 nginx-proxy 部署:这些服务**默认不占宿主机端口**,只挂在 agent-mcp-net 上被 agent 按容器名访问。 # 因此对外只需要开 agent-core 那一个端口(AGENT_PORT,默认 8090)。 # 需要从宿主机 curl 调试某个服务时,把它下面注释掉的 ports 两行打开。 services: @@ -10,7 +10,7 @@ services: # ports: # - "${WEB_SEARCH_PORT:-8081}:3000" networks: - - my-app-network + - agent-mcp-net mcp_image_gen: build: ./image_gen @@ -20,7 +20,7 @@ services: # ports: # - "${IMAGE_GEN_PORT:-8082}:3000" networks: - - my-app-network + - agent-mcp-net mcp_video_gen: build: ./video_gen @@ -35,10 +35,10 @@ services: # 本服务不搬字节:只把这条命令拼进工具描述,AI 自己在沙箱里 curl,拿回一条短命链接。 - PUBLIC_LINK_URL=${PUBLIC_LINK_URL:-http://agent-core:8081/public-link} networks: - - my-app-network + - agent-mcp-net networks: # 与 agent 仓库共用:网络由 agent 的 compose 创建并命名(所以要先起 agent), # 这里声明为 external 直接加入。agent-core / agent-executor 按容器名访问这些服务。 - my-app-network: + agent-mcp-net: external: true diff --git a/mcp/image_gen/README.md b/mcp/image_gen/README.md index 91184d9..cb81c02 100644 --- a/mcp/image_gen/README.md +++ b/mcp/image_gen/README.md @@ -21,7 +21,7 @@ cd /root/workspace/tools/mcp docker compose up -d --build mcp_image_gen ``` -服务容器名 `mcp_image_gen`,容器内端口 3000,**默认不占宿主端口**:agent 走 `my-app-network` +服务容器名 `mcp_image_gen`,容器内端口 3000,**默认不占宿主端口**:agent 走 `agent-mcp-net` 按容器名访问(`http://mcp_image_gen:3000/mcp`)。需要从宿主机 curl 调试时,去仓库根 `docker-compose.yml` 把 `mcp_image_gen` 注释掉的 `ports` 两行打开(默认写的是 8082),调试完记得注释回去。 diff --git a/mcp/video_gen/Dockerfile b/mcp/video_gen/Dockerfile index 5c7ca5f..e60de04 100644 --- a/mcp/video_gen/Dockerfile +++ b/mcp/video_gen/Dockerfile @@ -15,6 +15,6 @@ COPY . . EXPOSE 3000 -# HTTP 模式:只提供 MCP(/mcp)与 /health;容器外不映射,只在 my-app-network 内被 agent 访问。 +# HTTP 模式:只提供 MCP(/mcp)与 /health;容器外不映射,只在 agent-mcp-net 内被 agent 访问。 # 本地图片需要公网 URL 时,AI 去 curl agent 的内网签发入口(env PUBLIC_LINK_URL),本服务不搬字节。 CMD ["node", "src/mcp-server.js", "--http", "--port", "3000", "--host", "0.0.0.0"] \ No newline at end of file diff --git a/mcp/video_gen/README.md b/mcp/video_gen/README.md index c54a559..3274d5c 100644 --- a/mcp/video_gen/README.md +++ b/mcp/video_gen/README.md @@ -5,7 +5,7 @@ - 协议:MCP **Streamable HTTP**(单端点 `/mcp`,支持 SSE 流) - 上游:[智谱 BigModel 视频生成(异步)](https://docs.bigmodel.cn/api-reference/模型-api/视频生成异步) + [查询异步结果](https://docs.bigmodel.cn/api-reference/模型-api/查询异步结果) - 默认模型:`cogvideox-flash` -- 端口:容器内 `3000`(MCP `/mcp` + `/health`,**容器外不映射**,只在 `my-app-network` 内被 agent 访问) +- 端口:容器内 `3000`(MCP `/mcp` + `/health`,**容器外不映射**,只在 `agent-mcp-net` 内被 agent 访问) - 鉴权:**无服务端密钥**,每次请求必须从 header 携带智谱 token - 本地文件需要公网 URL 时:不传字节,让 AI 去 agent 的内网签发入口现签一条短命链接(见下节) @@ -22,7 +22,7 @@ cd /root/workspace/tools/mcp docker compose up -d --build mcp_video_gen ``` -服务容器名 `mcp_video_gen`,**默认不占宿主机端口**:由 agent 走 `my-app-network` 按容器名访问 +服务容器名 `mcp_video_gen`,**默认不占宿主机端口**:由 agent 走 `agent-mcp-net` 按容器名访问 (`http://mcp_video_gen:3000/mcp`)。需要从宿主机 curl 调试时,去仓库根 `docker-compose.yml` 把 `mcp_video_gen` 注释掉的 `ports` 两行打开(映的是 MCP 端口 3000,仅本机短时调试用)。 diff --git a/mcp/web_search/README.md b/mcp/web_search/README.md index c1bafe0..8e5f60a 100644 --- a/mcp/web_search/README.md +++ b/mcp/web_search/README.md @@ -37,7 +37,7 @@ MCP 端点: `docker-compose.yml` 中的 `mcp_web_search` 服务直接构建本目录,Dockerfile 已改为拷贝源码启动(不再有 `npm install -g`)。 -容器内监听 3000,**默认不占宿主端口**:agent 走 `my-app-network` 按容器名访问 +容器内监听 3000,**默认不占宿主端口**:agent 走 `agent-mcp-net` 按容器名访问 (`http://mcp_web_search:3000/`)。需要从宿主机 curl 调试时,把仓库根 `docker-compose.yml` 里 `mcp_web_search` 注释掉的 `ports` 两行打开(默认写的是 8081),调试完记得注释回去。