diff --git a/.env.compose.example b/.env.compose.example index a80ab56..6a51578 100644 --- a/.env.compose.example +++ b/.env.compose.example @@ -38,3 +38,11 @@ NPM_REGISTRY=https://registry.npmjs.org # IMAGE_MODEL_BASE_URL= # IMAGE_MODEL_API_KEY= # IMAGE_MODEL_ID= + +# ── 联网素材搜索 MCP(可选;需从 ai 容器访问该地址)── +# 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 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..f45f22b 100644 --- a/docker/README.md +++ b/docker/README.md @@ -40,6 +40,28 @@ docker compose logs --tail 100 api ai worker 首次登录后,在「设置」页配置模型。镜像不携带本机 `.env`、数据库或大屏工作区数据;本地 MCP 服务需要另外配置服务器可访问的地址。 +### 联网图片 / 视频素材搜索 MCP + +素材搜索连接的是独立的 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://<素材服务名>: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 +``` + +在服务器上检查过:FunBI 正常运行,Answer 网站也正常;但素材服务的 `8766` 端口当前没有监听。`127.0.0.1` 在容器里指向 AI 容器自身,因此先要在服务器启动 Answer Media Agent,并让 AI 容器通过同一 Docker 网络或受限私有网络访问它。不要为了连接而把带 Token 的素材 MCP 端口直接公开到公网。 + # GitHub CI/CD | 操作 | 工作流行为 |