问我AI

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 客户端

正式版桌面应用中,会创建、修改、发送、切换、中断或运行任何东西的工具都需要一个已配对的会话;只读工具在本机回环上无需配对即可使用。授权方法:

  1. 在 设置 → 手机和设备 中开启配对,获得一个配对码。
  2. 在本机用配对码换取会话令牌(把显示的配对码去掉空格):
    curl -X POST http://127.0.0.1:8799/api/auth/pair \
      -H 'content-type: application/json' \
      --data '{"code":"你的配对码","label":"本地 MCP 客户端"}'

    如果桌面应用使用了备用端口,请把 8799 换成设置里显示的端口。配对码只能使用一次,请复制返回的 token。

  3. 在 MCP 配置中固定同一个端口和令牌(WWB_PORT 以及会话令牌环境变量)。

已配对的客户端会和手机一起显示在 设置 → 手机和设备 中,可以随时撤销。请不要分享这个令牌,也不要把它提交到代码仓库。

自动发现连接

不做任何配置时,MCP 进程会依次探测 WenwoBot 桌面版的三个端口(8799、18799、28799),并且只接受自报为 WenwoBot 的健康检查响应。

这篇有帮助吗?
没有找到答案?告诉我们