WeQ MCP server
Commit 15. Nov. 2026Entschlüsselt und parst lokale NTQQ-Datenbanken, um Chat-Verläufe zu exportieren, Konversationen zu analysieren und eine MCP-Schnittstelle für AI Agents bereitzustellen.
Auch bekannt als weq-devs/WeQ
- Stars
- 331
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 15. Nov. 2026
- Lizenz
- —
Was ist WeQ MCP?
Entschlüsselt und parst lokale NTQQ-Datenbanken, um Chat-Verläufe zu exportieren, Konversationen zu analysieren und eine MCP-Schnittstelle für AI Agents bereitzustellen.
Zusammenfassung generiert aus dem README des Projekts
Über WeQ MCP server
WeQ ermöglicht es dir, NTQQ-Chatverläufe zu extrahieren und für KI-gestützte Analysen aufzubereiten. Dieses Tool entschlüsselt und parst lokale NTQQ-Datenbanken, um eine strukturierte Schnittstelle bereitzustellen, über die AI Agents mit deinen Konversationsdaten interagieren können. Es unterstützt verschiedene Chat-Typen, darunter private Nachrichten, Gruppenchats, Official Accounts und Channel-Chats.
Nutzer können den Server über eine Desktop-App auf Windows, macOS oder Linux ausführen oder die Web-Version für Headless-Umgebungen wie NAS, Server oder WSL nutzen. Das System übernimmt die dynamische Akquise der Datenbank-Keys, ohne dass ein Neustart von QQ oder ein vorheriges Login erforderlich ist. Nach der Einrichtung können Entwickler die MCP-Schnittstelle nutzen, um AI-Clients komplexe Aufgaben wie die Analyse von Jahresberichten oder spezifischen Chat-Threads zu ermöglichen.
Über einfachen Text hinaus kann das Tool Nachrichtenelemente wie Bubbles und Schriftarten parsen und Daten in Formaten wie JSON, TXT oder XLSX exportieren. Es bietet zudem Funktionen zum Einsehen gelöschter Nachrichten sowie zur Verwaltung von Kontaktinformationen oder Sammlungen.
Was du damit machen kannst
- 1Kontaktdaten verwaltenLass einen AI-Client deine Kontaktliste oder gespeicherte Elemente extrahieren und organisieren.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarweq-devs/weq is public and reachablegithub.com/weq-devs/weq ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)No licenseBefund
- Commit oder Release im letzten JahrLast commit or release 2026-11-13github.com/weq-devs/weq ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehen
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 协议开源。











