接入同栈 mcp 服务:compose 编排、文档与 wxbot→agent-wxbot 改名
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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_PORT>
|
||||
|
||||
对外只需要放行这一个端口。`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):工具接口设计规范。
|
||||
|
||||
|
||||
@@ -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:
|
||||
|
||||
@@ -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(),
|
||||
};
|
||||
|
||||
|
||||
+41
-6
@@ -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/<id>(见 public_link):AI 调内置工具
|
||||
# mint_public_link 在 core 进程内现签短链,不需要 executor 反查 core 的额外端口
|
||||
# 保留固定 name 是为了老机器上已有的容器/网络能平滑接上;新机器也可直接改回默认网络名。
|
||||
agent-mcp-net:
|
||||
name: agent-mcp-net
|
||||
driver: bridge
|
||||
|
||||
+1
-1
@@ -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 "完成 ✅"
|
||||
|
||||
+4
-4
@@ -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)
|
||||
```
|
||||
|
||||
|
||||
@@ -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 表;
|
||||
|
||||
Reference in New Issue
Block a user