WeQ MCPサーバー
コミット 2026年11月15日NTQQのローカルデータベースを復号・解析し、チャット履歴の書き出しや会話の分析、AIエージェント向けのMCPインターフェースの提供を行います。
別名 weq-devs/WeQ
- スター
- 331
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月15日
- ライセンス
- —
WeQ MCPとは
NTQQのローカルデータベースを復号・解析し、チャット履歴の書き出しや会話の分析、AIエージェント向けのMCPインターフェースの提供を行います。
プロジェクトのREADMEから生成された概要
WeQ MCP server について
WeQは、AIによるインサイトを得るためにNTQQのチャット履歴を抽出・分析することを可能にします。このツールは、ローカルのNTQQデータベースを復号および解析し、AIエージェントが会話データとやり取りするための構造化されたインターフェースを提供します。個人チャット、グループチャット、公式アカウント、チャンネルチャットなど、さまざまなチャット形式をサポートしています。
ユーザーは、Windows、macOS、またはLinux上のデスクトップアプリケーション経由でサーバーを実行できるほか、NAS、サーバー、WSLなどのヘッドレス環境向けにWeb版を使用することもできます。システムは、QQの再起動や事前ログインを必要とせずに、データベースキーを動的に取得します。セットアップ完了後、開発者はMCPインターフェースを利用して、年次報告書の分析や特定の会話スレッドの解析といった複雑なタスクをAIクライアントに実行させることができます。
単なるテキストだけでなく、吹き出しやフォントなどのメッセージ装飾を解析し、JSON、TXT、XLSXなどの形式でデータをエクスポートできます。また、削除されたメッセージの閲覧や、連絡先情報、コレクションの管理機能も備えています。
できること
- 1連絡先データの管理AIクライアントを使用して、連絡先リストや保存済みアイテムを抽出・整理します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能weq-devs/weq is public and reachablegithub.com/weq-devs/weq ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)No license検出事項
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-13github.com/weq-devs/weq ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
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 协议开源。











