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、参数或账号/会话标识。
下一步 → 语音转文字
