Files
agent/mcp
kicer 6b40ced355 officecli: 新增 Office 文档 MCP 服务(docx/xlsx/pptx 创建修改 + 浏览器实时预览)
- 零 npm 依赖 node shim:officecli mcp stdio→Streamable HTTP 桥(命令治理/交付取件链)+ watch 槽位 + 预览网关(:3100)
- 二进制不进 git 也不进镜像:entrypoint 容器首启拉取到命名卷 officecli-bin(pin v1.0.157+sha256,每次启动校验;源链 GitHub→gh-proxy,支持自托管镜像覆盖;离线可手工放置,sha 对上就认);clone 后 docker compose up 即完整入口
- server.js 启动自检 fail fast;compose 注册 mcp_officecli(scratch 工作区独立卷,不挂 agent/tasks)
2026-10-18 23:26:27 +08:00
..
2026-09-24 17:10:48 +08:00
2026-09-22 19:47:03 +08:00

MCP 服务集合

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

目录 容器名 作用 容器内端口 MCP 端点
web_search/ mcp_web_search 免费网页搜索(Parallel / Exa,无需 key) 3000 POST /
image_task/ mcp_image_task 智谱 CogView 图片生成(单工具 op=create) 3000 POST /mcp
video_task/ mcp_video_task 智谱 CogVideo 视频生成(异步,单工具 op=create/get) 3000 POST /mcp
officecli/ mcp_officecli Office 文档(docx/xlsx/pptx)创建修改 + 浏览器实时预览 3000/3100 POST /

officecli 的预览页面同样不占宿主机端口:浏览器走 agent-core 的通用预览反代 /preview/<会话id>/<文档>/…(登录 cookie 门禁),链路与槽位细节见 officecli/README.md。

这些服务一个宿主机端口都不占——它们只挂在 agent-mcp-net 上,由 agent-core / agent-executor 按容器名访问。所以整台服务器对外只需要开 agent-core 那一个端口(AGENT_PORT,默认 8090)。 (要从宿主机 curl 调试时,把 docker-compose.yml 里对应服务注释掉的 ports 两行打开。)

部署(无 nginx-proxy)

网络 agent-mcp-net 由 agent 的 compose 创建,所以全新机器上必须先起一次 agent:

# 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 agent-mcp-net declared as external, but could not be found),这是预期行为。 拆的时候反着来(先 down mcp 再 down agent)。

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

officecli 与 agent 不共盘:工作区是独立 scratch 卷(容器内布局同构 /workspace/tasks/<会话id>/..., 容器对会话数据盲视),数据交换只走桥的 push(mint 外链拉入)/ save 交付链(AI 在自己会话目录 curl 回写);且要先起 agent(external 网络 agent-mcp-net 由 agent 的 compose 创建)。

环境变量

写在仓库顶层 .env 里即可(不写就用默认值):

变量 默认 说明
WEB_SEARCH_PORT 8081 只在临时打开 web_search 调试端口时用
IMAGE_TASK_PORT 8082 只在临时打开 image_task 调试端口时用
VIDEO_TASK_PORT 8083 只在临时打开 video_task 调试端口(MCP 口,仅本机短时调试)时用

图片是怎么到智谱手上的(只有 video_task 关心)

智谱服务器生成视频前要自己来拉参考图,它不带 cookie、不带 Authorization。这套链路里没有任何人上传文件:

AI ──调用 agent 内置的「公开临时 URL」工具(直接传文件路径)──► 拿到一条短命公网 URL
      │
      ▼
AI 把拿到的 URL 当 image_url 交给 video_task:3000/mcp
      │
      ▼
智谱  ──匿名 GET──►  agent 侧提供的公开临时 URL
                        那个文件始终躺在 agent 的任务目录里,零拷贝
  • 签发与托管全在 agent 侧(它已集成为一个 tool,AI 直接调用即可,不需要 curl 任何内网入口)。
  • 链接短命:到期或 agent 重启后失效;智谱只在提交任务那一刻拉一次图,完全够用。
  • mcp 这三家一个端口都不露,唯一公网可达的东西只有 agent 自己。

端口与安全

服务 公网暴露 说明
mcp_web_search 无 服务端无鉴权,永远不要映射出去(会被白嫖搜索额度);agent 走内网访问
mcp_image_task 无 token 由调用方自带,暴露后可被拿去消耗你的智谱额度
mcp_video_task 无 它需要的公开临时 URL 由 agent 侧集成的工具提供,自己不占端口
mcp_officecli 无 MCP 口与预览网关口都只在内网;预览页由 agent-core 通用预览反代加登录 cookie 门禁

单独调试

docker compose up -d --build mcp_web_search
# 不占端口的健康检查
docker exec mcp_web_search node -e "fetch('http://localhost:3000/health').then(r=>r.text()).then(console.log)"

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