微信 Mac 客户端（运行中）
    ↓ scripts/extract_key.py（lldb 提取密钥）
keys.json（AES 密钥）
    ↓ scripts/decrypt_db.py（解密数据库）
decrypted/（标准 SQLite 文件）
    ↓ MCP Server（只读查询）
Kiro / Claude Desktop

cd /path/to/wechat-message
uv sync

# 先退出微信
sudo codesign --force --deep --sign - /Applications/WeChat.app

# 确保微信正在运行且已登录
sudo python3 scripts/extract_key.py

# 1. 以 sudo 启动 lldb 并附加微信
sudo lldb -n WeChat

# 2. 在 lldb 中执行：
(lldb) breakpoint set --name sqlite3_key
(lldb) breakpoint command add 1
# 输入以下 Python 代码，空行结束：
    import lldb
    frame = lldb.frame
    rsi = frame.FindRegister("rsi").GetValueAsUnsigned()
    rdx = frame.FindRegister("rdx").GetValueAsUnsigned()
    error = lldb.SBError()
    key = frame.thread.process.ReadMemory(rsi, rdx, error)
    if error.Success():
        print(f"KEY: {key.hex()}")
    
(lldb) continue

# 3. 微信登录后会打印类似：
#    KEY: aabbccdd...（64+ 字节的 hex）

# 4. 将输出的 hex 保存到 keys.json：

{
  "key_0": "x'<你复制的hex字符串>'"
}

python3 scripts/decrypt_db.py

decrypted/
├── contact/contact.db      # 联系人
├── session/session.db      # 会话列表
├── message/
│   ├── message_0.db        # 聊天记录（分片）
│   ├── message_1.db
│   └── ...
└── group/group.db          # 群组信息

{
  "mcpServers": {
    "wechat": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/wangfan/IdeaProjects/code/zhenling/wechat-message",
        "run",
        "python",
        "-m",
        "src.server"
      ],
      "disabled": false
    }
  }
}

{
  "mcpServers": {
    "wechat": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/wangfan/IdeaProjects/code/zhenling/wechat-message",
        "run",
        "python",
        "-m",
        "src.server"
      ]
    }
  }
}

export WECHAT_DECRYPTED_DIR=/your/custom/path

{
  "mcpServers": {
    "wechat": {
      "command": "uv",
      "args": ["--directory", "/path/to/project", "run", "python", "-m", "src.server"],
      "env": {
        "WECHAT_DECRYPTED_DIR": "/your/decrypted/path"
      }
    }
  }
}

# 查找联系人
list_contacts(keyword="王")

# 获取最近7天与某客户的聊天
get_chat_history(contact_name="张总", start_date="2026-07-21")

# 搜索关键词
search_messages(keyword="合同", contact_name="项目群")

# 生成本周聊天统计
summarize_chat(contact_name="工作群", period="this_week")

# 查看最活跃的10个会话
chat_stats_overview(period="last_30_days", top_n=10)

wechat-message/
├── src/
│   ├── server.py           # MCP Server 主入口（8个 Tools）
│   ├── config.py           # 路径配置和目录管理
│   ├── db/
│   │   ├── models.py       # 数据模型（Contact / Message / Session）
│   │   └── reader.py       # 数据库读取层
│   └── tools/
│       ├── contacts.py     # 联系人 Tools
│       ├── messages.py     # 消息 Tools
│       └── summary.py      # 统计汇总 Tools
├── scripts/
│   ├── extract_key.py      # 密钥提取（lldb）
│   └── decrypt_db.py       # 数据库解密
├── decrypted/              # 解密后的数据库（运行后生成）
├── keys.json               # 提取的密钥（运行后生成）
└── pyproject.toml