WenwoBot MCP 服务器
WenwoBot 桌面应用内置了一个本地 stdio MCP 服务器。在桌面应用运行时,其他 MCP 客户端可以通过它来协调你的 WenwoBot 团队。
能做什么
- 列出机器人和频道,包括它们当前的任务和活动;
- 分页读取对话记录、搜索本地对话(不返回截图像素);
- 创建并安全地编辑机器人资料、频道和独立的任务对话;
- 把工作发给某个机器人或频道,等待对话完成或需要帮助,以及中断正在进行的一轮;
- 列出已配置的模型实例,并把空闲的机器人切换到某个可用的模型。
这个服务器有意 不能:批准请求、记住权限授予、删除数据、导入团队、修改凭据,或控制电脑/虚拟机的生命周期。这些操作只能在面向人的应用里完成。
通过 wenwobot 命令运行
安装了 wenwobot npm 包后,MCP 客户端可以直接运行它:
{
"mcpServers": {
"wenwobot": { "command": "wenwobot", "args": ["mcp"], "env": { "WWB_PORT": "8799" } }
}
}
同样的操作也有独立的命令,适合脚本和 CI,见 在脚本和 CI 中运行 WenwoBot。
通过已安装的桌面应用运行
正式版已内置 server/mcp-server.js,可以用 Electron 自带的 Node 运行时来运行,无需另外安装 Node.js。
Windows 上,把已安装的 WenwoBot.exe 作为 command,旁边的 resources\server\mcp-server.js 作为参数,并设置环境变量 ELECTRON_RUN_AS_NODE=1。通常的按用户安装位置在 %LOCALAPPDATA%\Programs\WenwoBot 下。
macOS 示例:
{
"mcpServers": {
"wenwobot": {
"command": "/Applications/WenwoBot.app/Contents/MacOS/WenwoBot",
"args": ["/Applications/WenwoBot.app/Contents/Resources/server/mcp-server.js"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}
Ubuntu .deb 安装时,可执行文件通常是 /opt/WenwoBot/wenwobot,脚本是 /opt/WenwoBot/resources/server/mcp-server.js,环境变量相同。
授权外部 MCP 客户端
正式版桌面应用中,会创建、修改、发送、切换、中断或运行任何东西的工具都需要一个已配对的会话;只读工具在本机回环上无需配对即可使用。授权方法:
- 在 设置 → 手机和设备 中开启配对,获得一个配对码。
- 在本机用配对码换取会话令牌(把显示的配对码去掉空格):
curl -X POST http://127.0.0.1:8799/api/auth/pair \ -H 'content-type: application/json' \ --data '{"code":"你的配对码","label":"本地 MCP 客户端"}'如果桌面应用使用了备用端口,请把
8799换成设置里显示的端口。配对码只能使用一次,请复制返回的token。 - 在 MCP 配置中固定同一个端口和令牌(
WWB_PORT以及会话令牌环境变量)。
已配对的客户端会和手机一起显示在 设置 → 手机和设备 中,可以随时撤销。请不要分享这个令牌,也不要把它提交到代码仓库。
自动发现连接
不做任何配置时,MCP 进程会依次探测 WenwoBot 桌面版的三个端口(8799、18799、28799),并且只接受自报为 WenwoBot 的健康检查响应。