Files
agent/mcp/README.md
T
kicer ae13be047c 部署:改为 IP:端口直连(无 nginx-proxy),同步文档
- docker-compose: expose 3000 → ports(WEB_SEARCH_PORT/IMAGE_GEN_PORT/VIDEO_GEN_PORT 可覆盖,默认 8081/8082/8083),去掉 VIRTUAL_HOST/VIRTUAL_PORT/CERT_NAME
- video_gen: PUBLIC_BASE_URL 改为环境变量(默认 http://localhost:8083)
- 新增根 README:部署步骤、端口变量、端口暴露范围(8083 需对外,8081/8082 建议只内网)
- image_gen / video_gen / web_search README: 域名 URL 全部改为 IP:端口
2026-09-15 17:54:46 +08:00

2.6 KiB
Raw Blame History

MCP 服务集合

三个独立 MCP(Model Context Protocol)服务,各占一个目录,共用仓库根目录的 docker-compose.yml:

目录 容器名 作用 宿主机端口(默认) MCP 端点
web_search/ mcp_web_search 免费网页搜索(Parallel / Exa,无需 key) 8081 POST /
image_gen/ mcp_image_gen 智谱 CogView 图片生成 8082 POST /mcp
video_gen/ mcp_video_gen 智谱 CogVideo 视频生成(异步)+ 图片 /upload 8083 POST /mcp

部署(无 nginx-proxy,IP:端口直连)

这些服务与 agent 仓库的 agent-core 共用外部网络 my-app-network(agent 按容器名访问, 如 http://mcp_web_search:3000/),所以该网络要先创建一次:

docker network create my-app-network

image_gen / video_gen 需要智谱 token,但 token 不由服务端保存——每个请求从 header 读取 (agent 侧配在 config.yml 的 mcp_servers[].headers)。所以这里不用配任何密钥,直接起:

cd /root/workspace/tools/mcp
docker compose up -d --build

可选环境变量(写在仓库顶层 .env 即可,不写就用默认值):

变量 默认 说明
WEB_SEARCH_PORT 8081 web_search 映射到宿主机的端口
IMAGE_GEN_PORT 8082 image_gen 映射到宿主机的端口
VIDEO_GEN_PORT 8083 video_gen 映射到宿主机的端口
PUBLIC_BASE_URL http://localhost:8083 video_gen /upload 返回的 URL 前缀,必须是外部可达地址(智谱要能取到这张图);无域名时填 http://<服务器IP>:<VIDEO_GEN_PORT>

端口暴露范围(安全)

agent 走 my-app-network 用容器名 + 容器内端口(3000)访问,不依赖宿主机端口。所以对外 只建议放行 8083(原因见下),8081 / 8082 建议不对公网开放:

  • web_search:服务端无鉴权,暴露即被白嫖搜索额度。
  • image_gen:token 由调用方自带,暴露后可被拿来消耗你自己的智谱额度(若 token 泄露)。
  • video_gen:PUBLIC_BASE_URL 指向它,智谱服务器要能下载你上传的参考图,所以做图生视频时 必须对外放行。注意它的 /upload 与 /uploads/* 本身不鉴权(8MB / 24h 临时文件), 不需要图生视频就别放行。

单独调试

docker compose up -d --build mcp_web_search
curl http://localhost:8081/health

各目录下的 README.md 有该服务的工具说明、header 覆盖项与 curl 调试脚本。