wechat-decrypt-macos

微信 macOS 聊天记录解密与分析 MCP Server — 让 AI 直接读取和分析你的微信聊天记录

关键词: 微信解密 / WeChat Decrypt / MCP Server / Claude Code / 聊天记录分析 / macOS / SQLCipher / 密钥提取

v2.0 — MCP Server 版本

全新架构：从 CLI 工具升级为 MCP (Model Context Protocol) Server。现在你可以直接在 Claude Code 中对话式地查询和分析微信聊天记录，无需手动输入命令。

功能

• 🔑 从微信进程内存自动提取 SQLCipher 加密密钥
• 🔓 解密并查询微信本地聊天数据库 (message_*.db, contact.db)
• 💬 列出对话、读取消息、搜索关键词、获取最近消息
• 📊 聊天分析 — 消息统计、活跃度、时间分布
• 🤖 MCP 协议 — 可直接被 Claude Code、Cursor 等 AI 工具调用

前置条件

• macOS (Apple Silicon / Intel)
• Python >= 3.10
• sqlcipher: brew install sqlcipher
• 微信已安装并登录

安装

一键安装（推荐）

git clone https://github.com/cocohahaha/wechat-decrypt-macos.git
cd wechat-decrypt-macos
bash install.sh

脚本会自动：检查依赖 → 创建虚拟环境 → 安装包 → 注册 MCP Server 到 Claude Code。

手动安装

git clone https://github.com/cocohahaha/wechat-decrypt-macos.git
cd wechat-decrypt-macos
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

提取密钥（首次使用）

微信使用 SQLCipher 加密本地数据库。需要先提取 32 字节十六进制密钥，保存到项目根目录的 key.txt 文件中。

方法一：重签名 + 内存提取（推荐）

# 1. 退出微信

# 2. 重签名微信（移除 Hardened Runtime，首次使用/微信更新后需要）
sudo codesign --force --deep --sign - /Applications/WeChat.app

# 3. 重新启动微信并登录

# 4. 用 lldb 从进程内存中提取密钥
#    原理：WeChat 的 SQLCipher 派生密钥存储在进程内存中，
#    通过搜索数据库文件的 salt（前 16 字节）定位 codec_ctx 结构体，
#    从中提取 32 字节的派生密钥。
#
#    你可以使用任何能读取进程内存的工具来完成这一步。
#    提取到的密钥是 64 个十六进制字符（32 字节），格式如：
#    abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789

# 5. 将密钥保存到 key.txt
echo "你提取到的64位hex密钥" > key.txt

方法二：借助第三方工具

社区中有多种微信密钥提取工具可用，例如搜索「微信 macOS SQLCipher 密钥提取」。提取到密钥后，保存到项目根目录的 key.txt 即可。

验证密钥

# 将下面的 KEY 替换为你的实际密钥
sqlcipher ~/Library/Containers/com.tencent.xinWeChat/Data/Documents/xwechat_files/*/db_storage/message/message_0.db \
  "PRAGMA key = \"x'你的密钥'\"; PRAGMA cipher_compatibility = 4; PRAGMA cipher_page_size = 4096; SELECT count(*) FROM sqlite_master;"
# 如果输出数字（如 5），说明密钥正确

配置 Claude Code

推荐方式 — 使用 claude mcp add 命令（user scope，所有项目通用）：

claude mcp add -s user wechat /path/to/wechat-decrypt-macos/.venv/bin/python /path/to/wechat-decrypt-macos/server.py

例如：

claude mcp add -s user wechat ~/wechat-decrypt-macos/.venv/bin/python ~/wechat-decrypt-macos/server.py

如果使用了 bash install.sh 安装，脚本会自动完成注册。

在 ~/.claude.json 的 mcpServers 中添加：

{
  "mcpServers": {
    "wechat": {
      "type": "stdio",
      "command": "/path/to/wechat-decrypt-macos/.venv/bin/python",
      "args": ["/path/to/wechat-decrypt-macos/server.py"]
    }
  }
}

MCP 工具列表

使用方式

配置完成后，直接在 Claude Code 中用自然语言：

你：帮我看看最近和张三聊了什么
Claude：(自动调用 MCP 工具读取微信数据库，返回聊天摘要)

你：搜索一下我和李四聊天记录中提到"项目"的内容
Claude：(搜索并返回相关消息)

你：分析一下我最活跃的 5 个聊天对话
Claude：(查询数据库，返回统计分析)

联系人昵称（可选）

MCP 工具默认使用微信 ID 显示联系人。如果你希望显示昵称/备注名，可以创建 contacts.json：

cp contacts.example.json contacts.json
# 编辑 contacts.json，填入你的联系人信息

格式参考 contacts.example.json。该文件已在 .gitignore 中，不会被提交。

技术细节

• 架构: FastMCP Server (单文件 server.py, ~440 行)
• 加密: SQLCipher 4, cipher_page_size=4096, cipher_compatibility=4
• 密钥提取: 在进程内存中搜索数据库 salt → 定位 codec_ctx → 提取 32 字节派生密钥
• 协议: Model Context Protocol
• 内存读取: macOS Mach VM API (task_for_pid, mach_vm_read_overwrite)

兼容性

Star History

如果觉得有用，请给个 Star ⭐ 让更多人看到！

免责声明

本工具仅用于备份和分析自己的聊天记录。请遵守当地法律法规，不要用于未经授权的数据访问。

License

MIT