WeQ MCP server
Commit Nov 15, 2026Decrypts and parses NTQQ local databases to export chat history, analyze conversations, and provide an MCP interface for AI agents.
Also known as weq-devs/WeQ
- Stars
- 331
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 15, 2026
- License
- —
What is WeQ MCP?
WeQ decrypts and parses NTQQ local databases to export chat history, analyze conversations, and provide an MCP interface for AI agents.
Summary generated from the project's README
About WeQ MCP server
Extracting and analyzing NTQQ chat history for AI-driven insights is what WeQ enables. This tool decrypts and parses local NTQQ databases to provide a structured interface for AI agents to interact with your conversation data. It supports various chat types including private messages, group chats, official accounts, and channel chats.
Users can run the server via a desktop application on Windows, macOS, or Linux, or use the Web version for headless environments like NAS, servers, or WSL. The system handles database key acquisition dynamically without requiring a QQ restart or pre-login. Once set up, developers can use the MCP interface to allow AI clients to perform complex tasks like analyzing annual reports or specific conversation threads.
Beyond simple text, the tool can parse message decorations such as bubbles and fonts, and export data into formats like JSON, TXT, or XLSX. It also provides capabilities for viewing deleted messages and managing contact information or collections.
What you can do with it
- 1Manage contact dataHave an AI client extract and organize your contact list or saved items.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableweq-devs/weq is public and reachablegithub.com/weq-devs/weq ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-13github.com/weq-devs/weq ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub
WeQ 是一个 NTQQ 自主的本地数据库解密、解析与导出工具。
如果你需要导出和分析微信聊天记录:WeChatDataAnalysis 是相当不错的选择
核心功能
- 年度报告和单聊会话分析
- 好友克隆和克隆好友群聊(赛博斗蛐蛐)
- 消息防撤回和删除消息查看
- 聊天分析agent和MCP
| 高仿QQ聊天页面(装扮) | 好友克隆 |
|---|---|
![]() |
![]() |
| 导出聊天记录 | QQ个性装扮 |
![]() |
![]() |
| 年度/历史报告 | 修改/新增消息 |
![]() |
![]() |
| 离线防撤回 | agent助手 |
![]() |
![]() |
| 群相册查看和导出 | QQ空间导出html |
![]() |
![]() |
| 群聊/私聊分析 | QQ缓存资源清理 |
![]() |
![]() |
使用方法
- 前往 Releases 下载最新版本
- 按照引导操作获取数据库密钥
- 打开对应账号即可开始使用
[!tip]
支持的设备
系统 Windows MacOS Linux 架构 x64,不支持arm arm,intel x64,arm64
Arch Linux 用户可以直接从 AUR 安装预编译包,不必手动下载 Release:
paru -S weq-bin
web版
除桌面版外还提供 WeQ Web,复用桌面版的业务界面与后端,原生外壳能力存在差异。适合无桌面环境的机器 (NAS / 服务器 / WSL),或想从别的设备访问。
下载 weq-web-<版本>-<平台>.tar.gz(每个平台一个包,需自备 Node ≥ 22),
解压后直接运行启动脚本即可(Windows 双击 start.bat,Linux/macOS 执行 ./start.sh):
./start.sh # Linux / macOS
start.bat # Windows
终端会打印地址和访问令牌,浏览器打开即可。默认只监听本机; 对外暴露前请先读 apps/web/README.md。
已运行桌面版时,也可从「设置 → WeQ 服务 → Web 与 Remote」开启内置 Web,复用当前账号, 无需再启动独立 Node 服务。手机连接与两种 Web 宿主的能力边界见Web 服务与手机连接。
开发者指南
开始运行:
git clone https://github.com/weq-devs/WeQ # 克隆仓库代码
cd WeQ
git switch dev # 开发基于 dev,main 为发布分支
pnpm dev # 自动补齐依赖、native 和必要构建,启动开发服务器
源码开发需要 Node.js ≥ 22.12.0,并使用根 package.json 锁定的 pnpm@12.8.1;首次构建远程网络辅助程序需要 Go。默认无需 Rust,本地 native 模式才需要其编译工具链。来源配置与缓存行为见一行命令开发启动。
native 由 nt_helper_release 分发,
pnpm dev默认准备native/pinned.json锚定的发布版,不预下载大装扮索引;本地源码模式仍准备自己的配套资源。 装扮索引由 dress-resources 独立分发,桌面与 Web 安装包不再携带三份.dat, 应用按resources/dress/index-manifest.json的明确版本按需获取,并在宿主共享缓存中复用。 native 锚点过期时需验证并升级,同时更新兼容的索引清单;反复获取同一 tag 不会延长有效期。细节见 原生二进制与装扮资源的分发。
打包发布:
pnpm run build # = build:bot + 桌面版构建 + electron-builder(安装包)
pnpm --filter @weq/web build # 浏览器版(助手资源服务随 Web 进程运行)
贡献代码请先阅读 贡献指南 作为参考
QQ交流群
致谢
| 项目 | 参考 |
|---|---|
| NapNeko 团队 | 大量实现参考 |
| webark-im-template | QQ 聊天界面模板 |
| QQBackup | 整理保存了大量资料(虽然因为某个错误导致走了4个月弯路) |
同时也感谢每一个为WeQ及相关项目做出贡献的开发者:
开源协议
本项目基于 CC BY-NC-SA 4.0(知识共享 署名-非商业性使用-相同方式共享 4.0 国际)协议开源。这意味着你可以自由地使用、分享和修改本项目,但需遵守以下条款:
- 署名(BY) —— 必须注明原作者及项目来源,并注明是否做了修改。
- 非商业性使用(NC) —— 禁止用于任何商业用途,包括但不限于付费贩卖、倒卖本项目或其衍生作品。
- 相同方式共享(SA) —— 若你修改或基于本项目二次创作,衍生作品必须以相同的 CC BY-NC-SA 4.0 协议开源。











