From 4e9db3474295b89b9f1e419079b9ac95f33a0ea7 Mon Sep 17 00:00:00 2001 From: onweekend Date: Sun, 25 Oct 2026 04:19:02 -0700 Subject: [PATCH 1/3] fix: pass media asset MCP settings to AI service --- .env.compose.example | 7 +++++++ docker-compose.yml | 2 ++ docker/README.md | 20 ++++++++++++++++++++ 3 files changed, 29 insertions(+) diff --git a/.env.compose.example b/.env.compose.example index a80ab56..9c2aed9 100644 --- a/.env.compose.example +++ b/.env.compose.example @@ -38,3 +38,10 @@ NPM_REGISTRY=https://registry.npmjs.org # IMAGE_MODEL_BASE_URL= # IMAGE_MODEL_API_KEY= # IMAGE_MODEL_ID= + +# ── 联网素材搜索 MCP(可选;需从 ai 容器访问该地址)── +# MCP Streamable HTTP 地址,例如 http://media-assets-mcp:8766/mcp +# 不要填运行在你电脑上的 127.0.0.1;云服务器容器无法访问你电脑的 localhost。 +# MEDIA_ASSETS_MCP_URL= +# MCP 服务签发的 Bearer Token。请在服务器的 .env 中填写,不要提交到 Git。 +# MEDIA_ASSETS_MCP_TOKEN= diff --git a/docker-compose.yml b/docker-compose.yml index fac65d5..94625d1 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -146,6 +146,8 @@ services: <<: *server-env ROLE: ai PORT: "4112" + MEDIA_ASSETS_MCP_URL: ${MEDIA_ASSETS_MCP_URL:-} + MEDIA_ASSETS_MCP_TOKEN: ${MEDIA_ASSETS_MCP_TOKEN:-} volumes: - ai_workspace:/data/agent-workspace depends_on: diff --git a/docker/README.md b/docker/README.md index bef4601..19af429 100644 --- a/docker/README.md +++ b/docker/README.md @@ -40,6 +40,26 @@ docker compose logs --tail 100 api ai worker 首次登录后,在「设置」页配置模型。镜像不携带本机 `.env`、数据库或大屏工作区数据;本地 MCP 服务需要另外配置服务器可访问的地址。 +### 联网图片 / 视频素材搜索 MCP + +素材 MCP 由 `ai` 容器按需连接,使用 Streamable HTTP 和 Bearer Token。将以下两项写入服务器 `/root/funbi/.env`: + +```dotenv +MEDIA_ASSETS_MCP_URL=http://<服务器可访问的MCP主机>:8766/mcp +MEDIA_ASSETS_MCP_TOKEN=<该MCP服务签发的Token> +``` + +编辑 `.env` 时不要把 Token 粘贴到聊天或命令行参数中;保存后确认文件权限为 `600`。之后只重建 AI 容器以载入环境变量: + +```bash +cd /root/funbi +chmod 600 .env +docker compose up -d --no-deps --force-recreate ai +docker compose logs --tail 50 ai +``` + +`127.0.0.1` 指向当前容器自身。若 MCP 仍只运行在你的 Windows 电脑上,云服务器无法访问电脑的 `127.0.0.1:8766`;请将 MCP 服务部署到服务器可达的主机 / 私有网络,并确保 AI 容器能访问该地址。不要为了连接而将带 Token 的 MCP 端口直接公开到公网。 + # GitHub CI/CD | 操作 | 工作流行为 | From ce2e3324bc5baac37b1ca4251710caccd5e5d529 Mon Sep 17 00:00:00 2001 From: onweekend Date: Sun, 25 Oct 2026 04:35:11 -0700 Subject: [PATCH 2/3] fix: route AI container to host SSE MCP --- .env.compose.example | 5 ++--- docker-compose.yml | 2 ++ docker/README.md | 6 +++--- 3 files changed, 7 insertions(+), 6 deletions(-) diff --git a/.env.compose.example b/.env.compose.example index 9c2aed9..25f52a7 100644 --- a/.env.compose.example +++ b/.env.compose.example @@ -40,8 +40,7 @@ NPM_REGISTRY=https://registry.npmjs.org # IMAGE_MODEL_ID= # ── 联网素材搜索 MCP(可选;需从 ai 容器访问该地址)── -# MCP Streamable HTTP 地址,例如 http://media-assets-mcp:8766/mcp -# 不要填运行在你电脑上的 127.0.0.1;云服务器容器无法访问你电脑的 localhost。 -# MEDIA_ASSETS_MCP_URL= +# 服务器上的 Answer SSE 路由;host.docker.internal 由 Compose 映射到 Linux 宿主机。 +# MEDIA_ASSETS_MCP_URL=http://host.docker.internal:8080/answer/api/v1/mcp/sse # MCP 服务签发的 Bearer Token。请在服务器的 .env 中填写,不要提交到 Git。 # MEDIA_ASSETS_MCP_TOKEN= diff --git a/docker-compose.yml b/docker-compose.yml index 94625d1..5c2b890 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -148,6 +148,8 @@ services: PORT: "4112" MEDIA_ASSETS_MCP_URL: ${MEDIA_ASSETS_MCP_URL:-} MEDIA_ASSETS_MCP_TOKEN: ${MEDIA_ASSETS_MCP_TOKEN:-} + extra_hosts: + - "host.docker.internal:host-gateway" volumes: - ai_workspace:/data/agent-workspace depends_on: diff --git a/docker/README.md b/docker/README.md index 19af429..0f6b257 100644 --- a/docker/README.md +++ b/docker/README.md @@ -42,10 +42,10 @@ docker compose logs --tail 100 api ai worker ### 联网图片 / 视频素材搜索 MCP -素材 MCP 由 `ai` 容器按需连接,使用 Streamable HTTP 和 Bearer Token。将以下两项写入服务器 `/root/funbi/.env`: +素材 MCP 由 `ai` 容器按需连接,使用 SSE 和 Bearer Token。当前服务器的 Answer SSE 路由是 `http://127.0.0.1:8080/answer/api/v1/mcp/sse`。在 AI 容器中应通过 Docker 主机网关访问,因此写入服务器 `/root/funbi/.env` 的 URL 为: ```dotenv -MEDIA_ASSETS_MCP_URL=http://<服务器可访问的MCP主机>:8766/mcp +MEDIA_ASSETS_MCP_URL=http://host.docker.internal:8080/answer/api/v1/mcp/sse MEDIA_ASSETS_MCP_TOKEN=<该MCP服务签发的Token> ``` @@ -58,7 +58,7 @@ docker compose up -d --no-deps --force-recreate ai docker compose logs --tail 50 ai ``` -`127.0.0.1` 指向当前容器自身。若 MCP 仍只运行在你的 Windows 电脑上,云服务器无法访问电脑的 `127.0.0.1:8766`;请将 MCP 服务部署到服务器可达的主机 / 私有网络,并确保 AI 容器能访问该地址。不要为了连接而将带 Token 的 MCP 端口直接公开到公网。 +Compose 会将 `host.docker.internal` 映射到 Linux 宿主机,避免 `127.0.0.1` 指向 AI 容器自身。不要为了连接而将另一个带 Token 的 MCP 端口直接公开到公网。 # GitHub CI/CD From 14c927f295811d5e425af19b789cc25a04b68f27 Mon Sep 17 00:00:00 2001 From: onweekend Date: Sun, 25 Oct 2026 04:36:57 -0700 Subject: [PATCH 3/3] docs: distinguish Answer site MCP from media MCP --- .env.compose.example | 6 ++++-- docker-compose.yml | 2 -- docker/README.md | 8 +++++--- 3 files changed, 9 insertions(+), 7 deletions(-) diff --git a/.env.compose.example b/.env.compose.example index 25f52a7..6a51578 100644 --- a/.env.compose.example +++ b/.env.compose.example @@ -40,7 +40,9 @@ NPM_REGISTRY=https://registry.npmjs.org # IMAGE_MODEL_ID= # ── 联网素材搜索 MCP(可选;需从 ai 容器访问该地址)── -# 服务器上的 Answer SSE 路由;host.docker.internal 由 Compose 映射到 Linux 宿主机。 -# MEDIA_ASSETS_MCP_URL=http://host.docker.internal:8080/answer/api/v1/mcp/sse +# Answer Media Agent 素材 MCP 地址(不是 Answer 站点的 /answer/api/v1/mcp/sse 问答 MCP)。 +# 若素材服务和 FunBI AI 容器在同一 Docker 网络,可填 http://<服务名>:8766/mcp。 +# 地址必须能从 AI 容器访问;127.0.0.1 会指向 AI 容器自身。 +# MEDIA_ASSETS_MCP_URL= # MCP 服务签发的 Bearer Token。请在服务器的 .env 中填写,不要提交到 Git。 # MEDIA_ASSETS_MCP_TOKEN= diff --git a/docker-compose.yml b/docker-compose.yml index 5c2b890..94625d1 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -148,8 +148,6 @@ services: PORT: "4112" MEDIA_ASSETS_MCP_URL: ${MEDIA_ASSETS_MCP_URL:-} MEDIA_ASSETS_MCP_TOKEN: ${MEDIA_ASSETS_MCP_TOKEN:-} - extra_hosts: - - "host.docker.internal:host-gateway" volumes: - ai_workspace:/data/agent-workspace depends_on: diff --git a/docker/README.md b/docker/README.md index 0f6b257..f45f22b 100644 --- a/docker/README.md +++ b/docker/README.md @@ -42,10 +42,12 @@ docker compose logs --tail 100 api ai worker ### 联网图片 / 视频素材搜索 MCP -素材 MCP 由 `ai` 容器按需连接,使用 SSE 和 Bearer Token。当前服务器的 Answer SSE 路由是 `http://127.0.0.1:8080/answer/api/v1/mcp/sse`。在 AI 容器中应通过 Docker 主机网关访问,因此写入服务器 `/root/funbi/.env` 的 URL 为: +素材搜索连接的是独立的 Answer Media Agent MCP 服务,使用 `/mcp` Streamable HTTP 接口。Answer 网站的 `http://127.0.0.1:8080/answer/api/v1/mcp/sse` 是另一个问答 MCP,提供问题、回答、评论和标签等工具,不包含图片 / 视频素材搜索,不能填在这里。 + +将 Answer Media Agent 的地址和它签发的 Bearer Token 写入服务器 `/root/funbi/.env`。若素材服务与 FunBI AI 容器处于同一 Docker 网络,地址可用服务名: ```dotenv -MEDIA_ASSETS_MCP_URL=http://host.docker.internal:8080/answer/api/v1/mcp/sse +MEDIA_ASSETS_MCP_URL=http://<素材服务名>:8766/mcp MEDIA_ASSETS_MCP_TOKEN=<该MCP服务签发的Token> ``` @@ -58,7 +60,7 @@ docker compose up -d --no-deps --force-recreate ai docker compose logs --tail 50 ai ``` -Compose 会将 `host.docker.internal` 映射到 Linux 宿主机,避免 `127.0.0.1` 指向 AI 容器自身。不要为了连接而将另一个带 Token 的 MCP 端口直接公开到公网。 +在服务器上检查过:FunBI 正常运行,Answer 网站也正常;但素材服务的 `8766` 端口当前没有监听。`127.0.0.1` 在容器里指向 AI 容器自身,因此先要在服务器启动 Answer Media Agent,并让 AI 容器通过同一 Docker 网络或受限私有网络访问它。不要为了连接而把带 Token 的素材 MCP 端口直接公开到公网。 # GitHub CI/CD