WeQ MCP server
2026년 11월 15일 커밋NTQQ 로컬 데이터베이스를 복호화 및 파싱하여 채팅 기록을 내보내고, 대화를 분석하며, AI 에이전트를 위한 MCP 인터페이스를 제공합니다.
다른 이름 weq-devs/WeQ
- 스타
- 331
- Tools
- —
- 다운로드, 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 协议开源。











