改名:video_gen → video_task(双工具合并为单工具,op=create/get);image_gen → image_task(单工具,op=create)
- header 前缀同步改为 X-Video-Task-* / X-Image-Task-*(方案 B,agent 侧 config.yml 的 headers 需同步更新) - docker-compose 服务名 / 容器名 / 调试端口变量(VIDEO_TASK_PORT / IMAGE_TASK_PORT)同步改名 - README(根目录与两份服务文档)按新工具形态重写:op 参数表、curl 示例、架构图
This commit is contained in:
+9
-9
@@ -5,8 +5,8 @@
|
||||
| 目录 | 容器名 | 作用 | 容器内端口 | MCP 端点 |
|
||||
|---|---|---|---|---|
|
||||
| `web_search/` | `mcp_web_search` | 免费网页搜索(Parallel / Exa,无需 key) | `3000` | `POST /` |
|
||||
| `image_gen/` | `mcp_image_gen` | 智谱 CogView 图片生成 | `3000` | `POST /mcp` |
|
||||
| `video_gen/` | `mcp_video_gen` | 智谱 CogVideo 视频生成(异步) | `3000` | `POST /mcp` |
|
||||
| `image_task/` | `mcp_image_task` | 智谱 CogView 图片生成(单工具 op=create) | `3000` | `POST /mcp` |
|
||||
| `video_task/` | `mcp_video_task` | 智谱 CogVideo 视频生成(异步,单工具 op=create/get) | `3000` | `POST /mcp` |
|
||||
|
||||
**这些服务一个宿主机端口都不占**——它们只挂在 `agent-mcp-net` 上,由 `agent-core` / `agent-executor`
|
||||
按容器名访问。所以整台服务器对外只需要开 agent-core 那一个端口(`AGENT_PORT`,默认 8090)。
|
||||
@@ -27,7 +27,7 @@ cd /root/workspace/tools/mcp && docker compose up -d --build
|
||||
> mcp 单独在一个没有该网络的机器上先起会报错(`network agent-mcp-net declared as external, but could not be found`),这是预期行为。
|
||||
> 拆的时候反着来(先 down mcp 再 down agent)。
|
||||
|
||||
`image_gen` / `video_gen` 需要智谱 token,但 token **不由服务端保存**——每个请求从 header 读取
|
||||
`image_task` / `video_task` 需要智谱 token,但 token **不由服务端保存**——每个请求从 header 读取
|
||||
(agent 侧配在 `config.yml` 的 `mcp_servers[].headers`)。所以这里不用配任何密钥。
|
||||
|
||||
### 环境变量
|
||||
@@ -37,10 +37,10 @@ cd /root/workspace/tools/mcp && docker compose up -d --build
|
||||
| 变量 | 默认 | 说明 |
|
||||
|---|---|---|
|
||||
| `WEB_SEARCH_PORT` | `8081` | 只在临时打开 web_search 调试端口时用 |
|
||||
| `IMAGE_GEN_PORT` | `8082` | 只在临时打开 image_gen 调试端口时用 |
|
||||
| `VIDEO_GEN_PORT` | `8083` | 只在临时打开 video_gen 调试端口(MCP 口,仅本机短时调试)时用 |
|
||||
| `IMAGE_TASK_PORT` | `8082` | 只在临时打开 image_task 调试端口时用 |
|
||||
| `VIDEO_TASK_PORT` | `8083` | 只在临时打开 video_task 调试端口(MCP 口,仅本机短时调试)时用 |
|
||||
|
||||
## 图片是怎么到智谱手上的(只有 video_gen 关心)
|
||||
## 图片是怎么到智谱手上的(只有 video_task 关心)
|
||||
|
||||
智谱服务器生成视频前要**自己来拉参考图**,它不带 cookie、不带 `Authorization`。这套链路里**没有任何人上传文件**:
|
||||
|
||||
@@ -48,7 +48,7 @@ cd /root/workspace/tools/mcp && docker compose up -d --build
|
||||
AI ──调用 agent 内置的「公开临时 URL」工具(直接传文件路径)──► 拿到一条短命公网 URL
|
||||
│
|
||||
▼
|
||||
AI 把拿到的 URL 当 image_url 交给 video_gen:3000/mcp
|
||||
AI 把拿到的 URL 当 image_url 交给 video_task:3000/mcp
|
||||
│
|
||||
▼
|
||||
智谱 ──匿名 GET──► agent 侧提供的公开临时 URL
|
||||
@@ -64,8 +64,8 @@ AI 把拿到的 URL 当 image_url 交给 video_gen:3000/mcp
|
||||
| 服务 | 公网暴露 | 说明 |
|
||||
|---|---|---|
|
||||
| `mcp_web_search` | 无 | 服务端无鉴权,**永远不要映射出去**(会被白嫖搜索额度);agent 走内网访问 |
|
||||
| `mcp_image_gen` | 无 | token 由调用方自带,暴露后可被拿去消耗你的智谱额度 |
|
||||
| `mcp_video_gen` | 无 | 它需要的公开临时 URL 由 agent 侧集成的工具提供,自己不占端口 |
|
||||
| `mcp_image_task` | 无 | token 由调用方自带,暴露后可被拿去消耗你的智谱额度 |
|
||||
| `mcp_video_task` | 无 | 它需要的公开临时 URL 由 agent 侧集成的工具提供,自己不占端口 |
|
||||
|
||||
## 单独调试
|
||||
|
||||
|
||||
Reference in New Issue
Block a user