uv sync
uv add yara-python pymem pefile

# 微信聊天数据目录（xwechat_files 的实际路径，因人而异）
$env:WECHAT_FILES_DIR = "C:\Users\你的用户名\xwechat_files"

# 可选：自定义解密输出目录（默认为项目内 decrypted/）
# $env:WECHAT_DECRYPTED_DIR = "D:\你的路径\decrypted"

powershell -ExecutionPolicy Bypass -File .\start.ps1

powershell -ExecutionPolicy Bypass -File .\start.ps1

# 无需管理员权限，用 keys.json 里已有密钥重新解密
uv run python scripts\quick_decrypt.py

{
  "mcpServers": {
    "wechat": {
      "url": "http://localhost:8765/mcp",
      "disabled": false
    }
  }
}

# 根据新机器实际路径修改
$env:WECHAT_FILES_DIR = "C:\Users\新用户名\xwechat_files"

Get-ChildItem "C:\Program Files\Tencent" -Recurse -Filter "Weixin.dll" -ErrorAction SilentlyContinue | Select-Object FullName

$env:WECHAT_FILES_DIR = "C:\Users\你的用户名\xwechat_files"
$env:WEIXIN_DLL = "C:\Program Files\Tencent\Weixin\install\x.x.x\Weixin.dll"
uv run python scripts\decrypt_standalone.py

uv sync
uv add yara-python pymem pefile

Get-ItemProperty -Path "HKLM:\SOFTWARE\WOW6432Node\Tencent\WeChat" -Name "InstallPath" -ErrorAction SilentlyContinue
Get-ItemProperty -Path "HKLM:\SOFTWARE\Tencent\WeChat" -Name "InstallPath" -ErrorAction SilentlyContinue

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

uv sync

sudo codesign --force --deep --sign - /Applications/WeChat.app

sudo python3 scripts/extract_key.py

python3 scripts/decrypt_db.py

{
  "mcpServers": {
    "wechat": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/wechat-msg-mcp",
        "run", "python", "-m", "src.server"
      ],
      "disabled": false
    }
  }
}

uv run python -m src.server --transport streamable-http --host 0.0.0.0 --port 8765

{
  "mcpServers": {
    "wechat": {
      "url": "http://localhost:8765/mcp",
      "disabled": false
    }
  }
}

check_status()
list_contacts(keyword="王")
get_chat_history(contact_name="张总", start_date="2026-07-21")
search_messages(keyword="合同", contact_name="项目群")
summarize_chat(contact_name="工作群", period="this_week")
chat_stats_overview(period="last_30_days", top_n=10)

wechat-msg-mcp/
├── src/
│   ├── server.py               # MCP Server 主入口（优先本地 SQLite，回退 HTTP API）
│   ├── config.py               # 路径配置
│   ├── db/
│   │   ├── models.py           # 数据模型
│   │   ├── reader.py           # 本地 SQLite 读取（Mac + Windows 本地模式）
│   │   └── windows_reader.py   # Windows HTTP API 读取（WeChatDataAnalysis 回退）
│   └── tools/
│       ├── contacts.py
│       ├── messages.py
│       └── summary.py
├── scripts/
│   ├── extract_key.py          # macOS 密钥提取（lldb）
│   ├── decrypt_db.py           # 数据库解密（Mac & Windows 通用）
│   ├── decrypt_standalone.py   # Windows 独立解密（含密钥提取，需管理员权限）
│   ├── quick_decrypt.py        # Windows 快速重解密（用已有密钥，无需管理员）
│   └── extract_key_windows.py  # Windows 密钥提取（备用）
├── start.ps1                   # Windows 启动脚本（首次自动解密 + 启动 Server）
├── pyproject.toml
├── uv.lock
└── README.md

Get-ChildItem "C:\Program Files\Tencent" -Recurse -Filter "Weixin.dll" -ErrorAction SilentlyContinue | Select-Object FullName
$env:WEIXIN_DLL = "找到的完整路径\Weixin.dll"
uv run python scripts\decrypt_standalone.py

$env:WECHAT_FILES_DIR = "C:\Users\你的用户名\xwechat_files"

uv run python -m src.server --transport streamable-http --host 0.0.0.0 --port 8766