WeQ MCP server
Commit 15 Nov 2026Mendekripsi dan memparsing database lokal NTQQ untuk mengekspor riwayat chat, menganalisis percakapan, dan menyediakan interface MCP untuk AI agent.
Juga dikenal sebagai weq-devs/WeQ
- Stars
- 331
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 15 Nov 2026
- Lisensi
- —
Apa itu WeQ MCP?
Mendekripsi dan memparsing database lokal NTQQ untuk mengekspor riwayat chat, menganalisis percakapan, dan menyediakan interface MCP untuk AI agent.
Ringkasan dibuat dari README proyek
Tentang WeQ MCP server
WeQ memungkinkan Anda mengekstrak dan menganalisis riwayat chat NTQQ untuk mendapatkan insight berbasis AI. Tool ini mendekripsi dan memparsing database lokal NTQQ guna menyediakan interface terstruktur agar AI agent dapat berinteraksi dengan data percakapan Anda. Tool ini mendukung berbagai tipe chat termasuk pesan pribadi, grup chat, akun resmi, dan channel chat.
Pengguna dapat menjalankan server melalui aplikasi desktop di Windows, macOS, atau Linux, atau menggunakan versi Web untuk lingkungan headless seperti NAS, server, atau WSL. Sistem ini menangani akuisisi database key secara dinamis tanpa perlu restart QQ atau login terlebih dahulu. Setelah setup selesai, developer dapat menggunakan interface MCP untuk memungkinkan client AI melakukan tugas kompleks seperti menganalisis laporan tahunan atau thread percakapan tertentu.
Selain teks sederhana, tool ini dapat memparsing dekorasi pesan seperti bubble dan font, serta mengekspor data ke format seperti JSON, TXT, atau XLSX. Tool ini juga menyediakan kemampuan untuk melihat pesan yang telah dihapus serta mengelola informasi kontak atau koleksi.
Apa yang bisa Anda lakukan dengannya
- 1Kelola data kontakBiarkan client AI mengekstrak dan merapikan daftar kontak atau item yang Anda simpan.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauweq-devs/weq is public and reachablegithub.com/weq-devs/weq ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)No licenseTemuan
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-13github.com/weq-devs/weq ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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 协议开源。











