站点介绍
这是一个开源项目,专门为 macOS 用户设计,用来提取和解密微信本地数据库。微信在 macOS 上使用 SQLCipher 加密技术来保护用户的聊天记录和联系人信息,这个项目提供了一套完整的工具链,让用户能够安全地访问自己的微信数据。项目目前支持微信 4.x 版本,特别是在最新的 4.1.2-241 版本上进行过充分测试。
该项目的核心价值在于它提供了一个透明、可审计的方式来管理个人数据。用户可以完全掌控自己的聊天记录,进行备份、分析或导出,而不需要依赖微信官方的备份功能。同时,项目还支持与 AI 工具集成,让用户能够通过 Claude 等 AI 助手直接查询和分析微信数据。
功能介绍
首先是密钥提取功能,通过扫描微信进程的内存,找到用于加密数据库的密钥。这个过程需要禁用系统的安全保护机制(SIP),以获得足够的权限访问进程内存。
其次是数据库解密功能,利用提取出的密钥,将加密的 SQLCipher 数据库转换为可读的 SQLite 数据库。这样用户就能够用任何 SQLite 查看工具来浏览数据库内容。
再次是聊天记录导出功能,这个工具能够从解密后的数据库中提取聊天记录,并按照联系人或群组进行组织。导出的文件会使用联系人的显示名称而不是微信 ID,使得文件更容易识别和管理。
最后是密钥验证功能,用来确认提取出的密钥是否正确有效,能否成功解密对应的数据库。这个功能可以帮助用户快速诊断问题。
项目还提供了 MCP Server 集成,这是一个特别的功能,允许用户通过 Claude 等 AI 工具直接查询微信数据。AI 可以调用四个主要工具:获取最近的聊天会话列表、查看特定会话的聊天历史、在所有对话中搜索关键词,以及搜索和列出联系人信息。
使用方法
第一步是提取密钥。用户需要确保微信已经登录并正在运行,然后在终端中执行提取密钥的命令。这个过程会扫描微信进程的内存,找到加密密钥,并将其保存到一个 JSON 文件中。
PYTHONPATH=$(lldb -P) python3 find_key_memscan.py
第二步是解密数据库。使用提取出的密钥,运行解密脚本将加密的数据库文件转换为普通的 SQLite 数据库,这些解密后的文件会保存在一个专门的目录中。
第三步是导出聊天记录。这一步提供了多种导出选项,用户可以列出所有会话,也可以导出特定联系人的聊天记录。导出命令支持多种参数选项:
python3 export_messages.py
这个命令会列出所有的聊天会话。如果要导出特定联系人的记录,可以使用 -c 参数,支持模糊匹配联系人名称:
python3 export_messages.py -c "卡比"
也可以使用微信 ID 或群聊 ID:
python3 export_messages.py -c wxid_xxx python3 export_messages.py -c 12345@chatroom
如果只想导出最近的一些消息,可以加上 -n 参数指定数量:
python3 export_messages.py -c "卡比" -n 50
还可以在所有聊天记录中搜索关键词:
python3 export_messages.py -s "关键词"
或者一次性导出所有会话的聊天记录:
python3 export_messages.py --all
对于想要与 AI 工具集成的用户,可以安装 fastmcp 库,然后将这个项目注册为 Claude 的 MCP 服务。安装依赖:
pip3 install fastmcp
然后注册到 Claude:
claude mcp add wechat -- python3 $(pwd)/mcp_server.py
注册完成后,在 Claude 中就可以直接调用相关工具来查询微信数据,比如让 AI 帮你总结最近的聊天内容,或者搜索特定话题的讨论记录。
额外补充
项目目前star的数量并不是很高,但是也是一个好事,毕竟这类软件最终的结局可能就是被DMCA,毕竟之前Windows版本的同类型工具已经被处理了,腾讯的能力大家是有目共睹的,毕竟南山必胜客不是浪得虚名的。
鉴于我自己没有相关的设备以及使用需求,所以没有相关界面截图,感兴趣的可以自己尝试或者前往项目看看有无用户提供了相关截图演示。

