From 741839f5a7e858c39cabea554f64d37100730c78 Mon Sep 17 00:00:00 2001 From: kicer Date: Tue, 20 Oct 2026 15:13:36 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8E=A5=E5=85=A5=E5=90=8C=E6=A0=88=20mcp=20?= =?UTF-8?q?=E6=9C=8D=E5=8A=A1=EF=BC=9Acompose=20=E7=BC=96=E6=8E=92?= =?UTF-8?q?=E3=80=81=E6=96=87=E6=A1=A3=E4=B8=8E=20wxbot=E2=86=92agent-wxbo?= =?UTF-8?q?t=20=E6=94=B9=E5=90=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .env.example | 5 +++++ README.md | 30 ++++++++++++++++++++------ app/config.example.yml | 4 ++-- app/server/config.js | 4 ++-- docker-compose.yml | 47 +++++++++++++++++++++++++++++++++++------ scripts/init.sh | 2 +- wxbot/README.md | 8 +++---- wxbot/app/src/server.js | 2 +- 8 files changed, 79 insertions(+), 23 deletions(-) diff --git a/.env.example b/.env.example index 42a3df2..9f1117e 100644 --- a/.env.example +++ b/.env.example @@ -18,3 +18,8 @@ AUTH_SECRET=change-me-openssl-rand-hex-32 # agent-core 映射到宿主机的端口(默认 8090),改这里就不用动 docker-compose.yml # AGENT_PORT=8090 + +# ---- 仅调试:临时把对应 MCP 服务映射到宿主机端口(默认注释掉;改完记得注释回去)---- +# WEB_SEARCH_PORT=8081 +# IMAGE_TASK_PORT=8082 +# VIDEO_TASK_PORT=8083 diff --git a/README.md b/README.md index ea0862b..dc6f90d 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ | 长期记忆 | 会话收口时生成第一人称工作日记;微信新会话注入最近几条,`recall` 可检索全部 | | 用户画像 | 记录称谓、行业、偏好,会话创建时冻结注入,跨会话生效 | | 技能 | 目录式技能(`SKILL.md` + `run.py`/`run.sh`),可在设置页管理 | -| MCP | 启动时发现外部 MCP 服务的工具,与内置工具一起提供给模型 | +| MCP | 启动时发现 MCP 服务的工具;仓库内自带 `web_search` / `image_task` / `video_task` 三个 | | 多用户 | 登录账号、管理员角色、按用户隔离的会话列表与画像 | --- @@ -90,19 +90,23 @@ http://<服务器 IP>: 对外只需要放行这一个端口。`agent-executor`、`wxbot` 和 MCP 服务都只在 Docker 内网,不映射到宿主机。 -### 4. 使用外部 MCP 服务(可选) +### 4. 同栈 MCP 服务 -`init.sh` 默认写入同栈 MCP 服务: +`init.sh` 默认把仓库内 `mcp/` 的三个服务写进 `config.yml`: ```yaml mcp_servers: - name: web_search url: "http://mcp_web_search:3000/" + - name: image_task + url: "http://mcp_image_task:3000/mcp" + - name: video_task + url: "http://mcp_video_task:3000/mcp" ``` -这些服务未启动时,core 只在启动日志里告警,不影响 Web 主流程,但对应工具不会出现。需要时先启动 MCP 栈;不需要就在设置页删除或设为 `enable: false`。 +`web_search` / `image_task` / `video_task` 与 core 由同一个根 `docker-compose.yml` 启动,没有先后顺序,也不占宿主机端口。工具说明、header 覆盖项与调试方式见 [mcp/README.md](mcp/README.md)。 -> 全新机器上启动有先后顺序:先启动本仓库(创建 `agent-mcp-net`),再启动 MCP 仓库。MCP 侧声明该网络为 external。 +接入栈外的 MCP 服务:在设置页添加 `url` / `headers`,或在 `config.yml` 的 `mcp_servers` 追加一项。服务不可达时 core 只在启动日志里告警,不影响 Web 主流程,但对应工具不会下发给模型。 --- @@ -225,6 +229,7 @@ platforms: | `VIRTUAL_HOST` | 设置后 `public_link.base_url` 强制取 `https://<第一个域名>` | | `PREVIEW_PROXIES` | 覆盖内置预览反代注册表(JSON 数组) | | `EXECUTOR_LOG_LEVEL` / `WXBOT_LOG_LEVEL` | 两个附属服务的日志等级 | +| `WEB_SEARCH_PORT` / `IMAGE_TASK_PORT` / `VIDEO_TASK_PORT` | 仅调试:临时把对应 MCP 服务映射到宿主机端口(默认注释掉) | `config.yml` 与 `.env` 都含密钥,已在 `.gitignore` 中。不要提交,也不要挂给不需要它的容器。 @@ -351,12 +356,21 @@ docker compose up -d --build 数据库与任务目录都在 bind mount 中,升级不丢数据。进程重启时,执行中的回合会被打断;`active` 会话会归位为保持中,用户再发消息即可继续。 +> 从旧的「agent + mcp 双仓库」部署升级:旧 mcp 容器占着 `agent-mcp-net` 和同名 `container_name`,需先停旧栈再 `up` 本栈,否则会报 `network agent-mcp-net has active endpoints` 或 `container name ... is already in use`。旧仓库的 `down` 只需执行一次: +> +> ```bash +> cd /root/workspace/tools/mcp && docker compose down +> cd /root/workspace/tools/agent && docker compose up -d --build +> ``` +> +> 微信服务已改名为 `agent-wxbot`(原容器名 `wxbot`)。旧容器不受新 compose 管理,升级后需手动清理,否则两个实例会同时轮询同一个微信号:`docker rm -f wxbot`。 + ### 日志与健康检查 ```bash docker compose logs -f agent-core docker compose logs -f agent-executor -docker compose logs -f wxbot +docker compose logs -f agent-wxbot curl -s http://127.0.0.1:8090/api/health ``` @@ -368,7 +382,7 @@ curl -s http://127.0.0.1:8090/api/health | 现象 | 原因 / 处理 | |---|---| -| 启动时报 `network agent-mcp-net has active endpoints` | 先停 MCP 栈,再停本栈;重新 `up` 会恢复 | +| 启动时报 `network agent-mcp-net has active endpoints` | 旧的双仓库部署残留:先停旧的 mcp 仓库(`docker compose down`),再 `up` 本栈 | | `config.yml` 变成目录 | 启动前文件不存在,Docker 自动建了同名目录;停容器、删目录、放入配置文件 | | 没有可用模型 | `platforms` 为空或模型全部禁用;在设置页添加后重启 | | 创建会话报「无可用模型」 | 模型池为空,或指定模型所在平台没有 key | @@ -385,6 +399,7 @@ agent/ ├── app/ agent-core:Express + SQLite + 前端静态资源 ├── executor/ agent-executor:隔离命令执行与 Office 预览网关 ├── wxbot/ 微信 iLink 协议调制解调器 +├── mcp/ 同栈 MCP 服务:web_search / image_task / video_task ├── skills/ 技能目录 ├── tasks/ 会话工作目录(运行时生成) ├── data/ SQLite 与调试产物(运行时生成) @@ -395,6 +410,7 @@ agent/ 进一步阅读: +- [mcp/README.md](mcp/README.md):同栈 MCP 服务(搜索 / 生图 / 生视频)。 - [docs/OFFICE.md](docs/OFFICE.md):Office 文档技能与预览链路。 - [docs/tool-design.md](docs/tool-design.md):工具接口设计规范。 diff --git a/app/config.example.yml b/app/config.example.yml index ca9fa60..a28d354 100644 --- a/app/config.example.yml +++ b/app/config.example.yml @@ -28,7 +28,7 @@ db_path: "" # 留空取 data_root/.agent. log_level: "info" # debug < info < warn < error < none(仅 core 自身;executor/wxbot 的日志等级另走 EXECUTOR_LOG_LEVEL / WXBOT_LOG_LEVEL env,compose 注) # executor(命令执行)与 wxbot(微信接入)均**不是本文件的配置项**,接线全走根 compose 注入的 env(见 .env.example): -# EXECUTOR_URL / EXECUTOR_TOKEN;WXBOT_URL(默认 http://wxbot:8093,置空=微信入口静默关闭)/ WXBOT_TOKEN(init.sh 生成,两侧同值)。 +# EXECUTOR_URL / EXECUTOR_TOKEN;WXBOT_URL(默认 http://agent-wxbot:8093,置空=微信入口静默关闭)/ WXBOT_TOKEN(init.sh 生成,两侧同值)。 terminal: default_timeout_ms: 30000 # 命令默认超时(ms) @@ -78,7 +78,7 @@ auth: # users 留空 = 不启用登 role: admin # admin=管理员(全部设置 + 用户管理);user 或缺省=普通用户(仅账户页) # model: qwen-tp/qwen3.8-flash # 选填:该用户新建会话时锁定的模型(内部键「平台名/模型id」) -# 外部 MCP 服务列表:每项 {name?, url, headers?, enable?(默认 true), timeout_ms?, tools_allow?, tools_deny?}。 +# MCP 服务列表(仓库自带的 mcp/ 三个服务,或栈外服务):每项 {name?, url, headers?, enable?(默认 true), timeout_ms?, tools_allow?, tools_deny?}。 mcp_servers: [] public_link: diff --git a/app/server/config.js b/app/server/config.js index ae0f699..7f44e15 100644 --- a/app/server/config.js +++ b/app/server/config.js @@ -287,10 +287,10 @@ function parseAndValidate(rawText, configPath) { }; // 微信接入(wechat.js):纯 env 接线(wxbot 为栈内组件,不再是 config.yml 字段;旧文件里的 wxbot: 段直接忽略)。 - // WXBOT_URL 缺省 http://wxbot:8093(compose 注同名 env,置空 = 微信入口整体静默关闭); + // WXBOT_URL 缺省 http://agent-wxbot:8093(compose 注同名 env,置空 = 微信入口整体静默关闭); // WXBOT_TOKEN 未配 = 关闭(init.sh 生成,core ↔ wxbot 两侧同值)。cfg.wxbot 仍作为运行期访问器供 wechat/routes 读取。 cfg.wxbot = { - url: String(process.env.WXBOT_URL != null ? process.env.WXBOT_URL : 'http://wxbot:8093').trim().replace(/\/+$/, ''), + url: String(process.env.WXBOT_URL != null ? process.env.WXBOT_URL : 'http://agent-wxbot:8093').trim().replace(/\/+$/, ''), token: String(process.env.WXBOT_TOKEN || '').trim(), }; diff --git a/docker-compose.yml b/docker-compose.yml index 58483c5..513d665 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -22,7 +22,7 @@ services: # 未设置则 compose 直接报错,避免静默无鉴权。生成:openssl rand -hex 32 - EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - see .env.example} # 微信接入 - - WXBOT_URL=http://wxbot:8093 + - WXBOT_URL=http://agent-wxbot:8093 - WXBOT_TOKEN=${WXBOT_TOKEN:?WXBOT_TOKEN not set - run scripts/init.sh} networks: - agent-mcp-net @@ -132,10 +132,10 @@ services: # 微信接入:iLink 协议多实例调制解调器(agent 栈的私有组件,与 core 共用 WXBOT_TOKEN 互信)。 # 仅挂内网 agent-mcp-net、不暴露任何公网端口:扫码二维码在 agent-core 设置页呈现(core 代理其 /api/instances/:id/qr.svg)。 # 零配置文件:接线全靠下方 env(同 executor 模式);代码在 ./wxbot/(已并入仓库)。 - wxbot: + agent-wxbot: build: ./wxbot/app - image: wxbot:latest - container_name: wxbot + image: agent-wxbot:latest + container_name: agent-wxbot restart: unless-stopped environment: - WXBOT_TOKEN=${WXBOT_TOKEN:?WXBOT_TOKEN not set - run scripts/init.sh} @@ -148,12 +148,47 @@ services: networks: - agent-mcp-net + # ---------------------------------------------------------------- + # 同栈 MCP 服务(./mcp/):三个 Model Context Protocol 适配器,由 core 按容器名调用。 + # 全部不占宿主机端口、无服务端鉴权,**永远不要**把 ports 映射出去(会被白嫖额度)。 + # 工具说明、header 覆盖项与 curl 调试见 mcp/README.md 及各子目录 README。 + # ---------------------------------------------------------------- + mcp_web_search: + build: ./mcp/web_search + container_name: mcp_web_search + restart: unless-stopped + # 调试用(默认关): + # ports: + # - "${WEB_SEARCH_PORT:-8081}:3000" + networks: + - agent-mcp-net + + mcp_image_task: + build: ./mcp/image_task + container_name: mcp_image_task + restart: unless-stopped + # 调试用(默认关): + # ports: + # - "${IMAGE_TASK_PORT:-8082}:3000" + networks: + - agent-mcp-net + + mcp_video_task: + build: ./mcp/video_task + container_name: mcp_video_task + restart: unless-stopped + # 调试用(默认关;这里映的是 MCP 端口,会暴露 /mcp,仅本机短时调试用): + # ports: + # - "${VIDEO_TASK_PORT:-8083}:3000" + networks: + - agent-mcp-net + networks: - # 全部服务共用一个网络;由本仓库创建(固定名字,避免被加上 compose 项目名前缀),mcp 侧声明为 - # external 直接加入 —— 所以全新机器上要【先起 agent,再起 mcp】。 + # 全部服务共用一个网络;由本仓库创建(固定名字,避免被加上 compose 项目名前缀)。 # - core 与 executor 靠它按容器名访问 MCP 服务(如 http://mcp_web_search:3000/) # - 外部服务取参考图走的是 core 对外的 GET /p/(见 public_link):AI 调内置工具 # mint_public_link 在 core 进程内现签短链,不需要 executor 反查 core 的额外端口 + # 保留固定 name 是为了老机器上已有的容器/网络能平滑接上;新机器也可直接改回默认网络名。 agent-mcp-net: name: agent-mcp-net driver: bridge diff --git a/scripts/init.sh b/scripts/init.sh index 88203f2..587660e 100755 --- a/scripts/init.sh +++ b/scripts/init.sh @@ -247,7 +247,7 @@ echo " 账号 : $AUTH_USER" echo " 密码 : $AUTH_PASSWORD" echo " 平台 : ${enabled_plats[*]:-(无)}" echo " 图像/视频: $([ -n "$BIGMODEL_KEY" ] && echo "image_task / video_task 已启用" || echo "未配置(enable: false)")" -echo " Office : officecli 已接入(mcp_officecli:3000;预览走 /preview 反代)" +echo " MCP 服务 : web_search / image_task / video_task(同栈,随 compose 启动)" echo " 微信接入 : WXBOT_TOKEN 已就位(compose 注入 core 与 wxbot 两侧;wxbot 无需配置文件)" echo "---------------------------------------------" log "完成 ✅" diff --git a/wxbot/README.md b/wxbot/README.md index 0ae948d..a21e7b1 100644 --- a/wxbot/README.md +++ b/wxbot/README.md @@ -7,18 +7,18 @@ Agent 栈的微信「调制解调器」:基于官方 iLink 协议的 Node SDK **本服务不保存业务状态、不对外服务**:绑定关系(core 用户 ↔ bot 账号)的权威在 agent-core 的 `wechat_bindings` 表;扫码二维码呈现在 agent-core 的 Web 设置页 -(账户 → 微信绑定)。本服务已并入根 `docker-compose.yml`(`wxbot` 服务),目录代码已入 git 库; +(账户 → 微信绑定)。本服务已并入根 `docker-compose.yml`(`agent-wxbot` 服务),目录代码已入 git 库; 零配置文件运行,接线全靠 compose 注入的 env(见下)。 ## 架构与数据流 ``` -微信用户 ⇄ [iLink] ⇄ wxbot(本服务, :8093, 仅内网 agent-mcp-net) +微信用户 ⇄ [iLink] ⇄ agent-wxbot(本服务, :8093, 仅内网 agent-mcp-net) │ 收信转发 POST core:/wxhook/inbox {id, from, text} │ 状态回调 POST core:/wxhook/hook {id, event, accountId?} │ 接收投递 POST self:/api/deliver ← core 推最终回复 agent-core ⇄ 浏览器 ⇄ core:/api/wechat(cookie 鉴权,绑定管理 + QR SVG 代理) - │ 实例控制 POST/DELETE wxbot:/api/instances* + │ 实例控制 POST/DELETE agent-wxbot:/api/instances* └ 总线监听 assistant 消息 → 分段投递(游标落库不重发) ``` @@ -51,7 +51,7 @@ agent-core 的 `wechat_bindings` 表;扫码二维码呈现在 agent-core 的 W ```sh ./scripts/init.sh --env-only # 生成/复用根 .env 的 WXBOT_TOKEN(幂等,不碰 config.yml) -docker compose up -d --build wxbot # 首次构建镜像(npm 源可 --build-arg NPM_REGISTRY= 换) +docker compose up -d --build agent-wxbot # 首次构建镜像(npm 源可 --build-arg NPM_REGISTRY= 换) docker compose up -d agent-core # core 带 WXBOT_URL/WXBOT_TOKEN 重建(compose 检测到 env 变化自动 recreate) ``` diff --git a/wxbot/app/src/server.js b/wxbot/app/src/server.js index 0ffa953..3e6976a 100644 --- a/wxbot/app/src/server.js +++ b/wxbot/app/src/server.js @@ -1,4 +1,4 @@ -// wxbot:Agent 栈的微信「调制解调器」(wxbot 只服务本 agent、不对外暴露,作为根 compose 的 wxbot 服务已并入仓库)。 +// wxbot:Agent 栈的微信「调制解调器」(wxbot 只服务本 agent、不对外暴露,作为根 compose 的 agent-wxbot 服务已并入仓库)。 // - 基于 @wechatbot/wechatbot(官方 iLink 协议 Node SDK),同进程多实例: // 一个实例 = 一个 core 用户的 bot 账号(扫码登录后仅本人可与 bot 单线对话,协议保证无陌生人入口)。 // - 本服务不保存任何业务状态:绑定(core 用户 ↔ 实例)权威在 agent-core 的 wechat_bindings 表;