Skip to content

MCP 服务器 ​

WeQ 内置一个 MCP(Model Context Protocol)服务器,让外部 AI 客户端(Claude Desktop 等) 通过本地 HTTP 接口读取当前账号的聊天数据。

打开位置:设置 → WeQ 服务 → MCP 服务器。

list_settings 可列出 WeQ 的设置名称、稳定 ID、所属页面、搜索别名和页面恢复范围,与设置前端、全局搜索及设置项参考共用同一注册表。可按 page 或 query 筛选;它只返回公开定义,不读取当前设置值,也不修改设置。

1. 服务开关 ​

  • 启用 MCP 服务器:开启后开始监听;首次开启会自动生成令牌;
  • 服务与账号绑定:仅在已登录账号时监听,切换 / 退出账号会自动停止;
  • 关闭窗口默认只最小化到托盘,服务继续监听;完全退出 WeQ 时才停止。运行状态也可在「WeQ 服务 → 后台服务」页统一查看;
  • 只绑 127.0.0.1,每个请求都需要带 Bearer 令牌;
  • 状态行显示「运行中 / 已启用(等待账号)/ 已停止」与访问地址,可一键复制。
  • 读取失败显示原因并可重试,不把未知状态当作已停止;未读取到状态时不能切换服务或重新生成令牌。

2. 连接信息 ​

该服务器只注册审核过的工具。令牌不能执行 SQL、发送或回应消息、修改防撤回设置、导出/解密任意文件、操作红包或提取账号凭据,也不能运行脚本;内置助手开启任意权限不会改变此令牌的权限。查询仍可能按工具约定访问 QQ 在线接口,不表示完全离线。

WARNING

令牌可以切换账号。 服务器提供 list_accounts / switch_account,持有令牌的客户端 能让你从当前账号切到本机任意一个已保存的账号,然后读取那个账号的聊天数据。 也就是说,令牌覆盖的是这台机器上所有已保存账号,不只是当前打开的那个。 请像对待密码一样保管令牌;不想承担这个范围时,把不用的账号记录从列表里删掉。

账号切换 ​

  • list_accounts:列出本机已保存的账号记录(configId / uin / 昵称 / 是否静态 / 是否当前)。 同一个 QQ 号可能同时有「在线账号」和「导入的备份账号」两条记录,用 configId 认账号。
  • switch_account:把 WeQ 切换到 configId 指定的账号。

切换是异步的:调用成功只表示请求已交给界面,实际切换要几秒(关旧账号 → 重开 → 预热), 工具调用本身不会在完成时再来通知。想确认切好了,稍等再调 get_self_profile 看 uin。

  • 切换由界面执行,与点左上角头像切号走完全相同的流程(会弹出切号载入页); 窗口在托盘里时会自动唤起。
  • 当前没有打开的 WeQ 界面时,switch_account 会直接报错,不会假装成功。
  • 若界面里有未保存的邮件草稿,会弹确认框;用户取消则切换不会发生,工具无法得知这个结果, 以 get_self_profile 的实际 uin 为准。
项说明
端口修改后立即重启服务(若正在运行)。端口被占用时最多尝试 20 个候选端口,自动跳过其他 WeQ 服务的预留范围,并在提示里告知实际端口
令牌可显示 / 隐藏 / 复制;可重新生成
客户端配置可粘贴的客户端配置 JSON 片段

3. 一键安装到本机 AI 客户端 ​

  • 扫描本机已安装的 MCP 客户端:列出各客户端的安装状态;
  • 每个客户端显示状态:已是最新 / 需更新 / 可安装;
  • 勾选后点安装,WeQ 会把自身写入选中的客户端(会自动启用服务,不重复安装);
  • 安装完成提示「重启 AI 客户端后即可在对话中调用 WeQ 工具」;
  • 支持重新扫描。

INFO

拿到令牌就等于拿到当前账号的聊天数据,请像对待密码一样保管令牌,不要把地址和令牌暴露到 公网。

4. 消息性能快照 ​

get_message_performance 只读取当前账号的性能统计,不触发聊天查询。 普通启动返回排队、原生等待及阶段汇总;以 WEQ_DATABASE_DIAGNOSTICS=1 启动时, 额外返回匿名请求编号、查询指纹、源码调用点和在途关联。 逐查询记录有界且只保留在内存,不包含正文、SQL、参数或账号/会话标识。


下一步 → 语音转文字

当前文档对应 v2.7.4 · 已发布内容以 CHANGELOG 为准