{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_7v84uqbcx5xn","handle":"wechat-claudecode-mcp","url":"https://wellknown.network/agents/wechat-claudecode-mcp","links":{"self":"https://wellknown.network/agents/wechat-claudecode-mcp/record.json","html":"https://wellknown.network/agents/wechat-claudecode-mcp","markdown":"https://wellknown.network/agents/wechat-claudecode-mcp/record.md","api":"https://wellknown.network/api/v1/agents/wechat-claudecode-mcp","status":"https://wellknown.network/api/v1/agents/wechat-claudecode-mcp/status","claim":"https://wellknown.network/agents/wechat-claudecode-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/wechat-claudecode-mcp/claim.json","badge":"https://wellknown.network/agents/wechat-claudecode-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:wechat-claudecode-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"wechat-claudecode-mcp","summary":"WeChat MCP Server — let AI query your WeChat messages directly","description":"# WeChat × Claude Code MCP\n\n让 Claude Code 直接读取你的微信聊天记录。支持 macOS 和 Windows。\n\n提取微信 (WeChat) 数据库密钥，解密 SQLCipher 加密的本地数据库，导出聊天记录。内置 MCP Server，让 AI 直接查询微信数据——不需要截图，不需要复制粘贴，你的 Claude 可以直接搜索、浏览、分析你的所有微信对话。\n\n## 功能\n\n- 🔑 **密钥提取**：macOS 通过 LLDB 内存扫描，Windows 通过 pymem 进程内存搜索\n- 🔓 **数据库解密**：使用 SQLCipher 解密所有本地数据库（消息、联系人、会话等）\n- 💬 **消息导出**：按联系人/群聊导出，支持模糊匹配、关键词搜索、日期筛选\n- 🤖 **MCP Server**：注册到 Claude Code 后，AI 可直接查询微信数据\n- 📡 **消息轮询**：实时监听指定对话的新消息，适配 Claude Code 的微信聊天模式\n\n## 安装\n\n### 通过 pip 安装（推荐）\n\n```bash\npip install wechat-claudecode-mcp\n```\n\n安装后可用以下命令：\n\n| 命令 | 功能 |\n|------|------|\n| `wechat-mcp` | 启动 MCP Server |\n| `wechat-mcp-keygen` | 提取密钥（macOS） |\n| `wechat-mcp-keygen-win` | 提取密钥（Windows） |\n| `wechat-mcp-decrypt` | 解密数据库 |\n| `wechat-mcp-export` | 导出聊天记录 |\n| `wechat-mcp-verify` | 验证密钥 |\n| `wechat-mcp-poll` | 轮询新消息 |\n\n### 从源码安装\n\n```bash\ngit clone https://github.com/SsssssSynqa/WeChat-ClaudeCode-MCP.git\ncd WeChat-ClaudeCode-MCP\npip install -e .\n```\n\n### 系统依赖\n\nmacOS 还需要：\n\n```bash\nbrew install llvm sqlcipher\n```\n\n## 快速开始（macOS）\n\n### 1. 前置条件\n\n- macOS arm64，微信 4.x\n- 禁用 SIP：`csrutil disable`（提取密钥时需要，解密和查询不需要）\n- 安装系统依赖：`brew install llvm sqlcipher`\n\n### 2. 提取密钥\n\n确保微信已登录并正在运行：\n\n```bash\nPYTHONPATH=$(lldb -P) wechat-mcp-keygen\n```\n\n密钥保存到 `~/.wechat-mcp/wechat_keys.json`。提取一次即可，微信大版本更新后需重新提取。\n\n### 3. 注册 MCP Server 到 Claude Code\n\n```bash\nclaude mcp add wechat -- wechat-mcp\n```\n\n就这么简单！注册后 AI 可以直接调用以下能力：\n\n| Tool | 功能 |\n|------|------|\n| `get_recent_sessions` | 获取最近会话列表 |\n| `get_chat_history` | 查看聊天记录（支持模糊匹配、日期筛选） |\n| `search_messages` | 跨会话搜索关键词 |\n| `get_contacts` | 搜索联系人 |\n\nMCP Server 直接查询加密数据库（通过 sqlcipher3），无需预先解密，始终读取最新消息。\n\n### 4. 其他工具（可选）\n\n```bash\n# 解密数据库（离线分析用）\nwechat-mcp-decrypt\n\n# 导出聊天记录\nwechat-mcp-export                     # 列出所有会话\nwechat-mcp-export -c \"联系人名字\"      # 导出指定会话\nwechat-mcp-export -s \"关键词\"          # 搜索关键词\nwechat-mcp-export --all               # 导出所有会话\n\n# 轮询新消息（实时监听）\nwechat-mcp-poll wxid_xxx              # 每8秒检查一次\nwechat-mcp-poll wxid_xxx 5            # 自定义间隔\nwechat-mcp-po…","publisher":null,"homepage":"https://github.com/SsssssSynqa/WeChat-ClaudeCode-MCP","repository":"https://github.com/SsssssSynqa/WeChat-ClaudeCode-MCP","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:wechat-claudecode-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"wechat-claudecode-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:27.405Z","publishedAt":"2026-03-16T02:08:53.581914Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"wechat-claudecode-mcp","url":"https://pypi.org/project/wechat-claudecode-mcp/","firstSeenAt":"2026-09-10T15:24:29.095Z","fetchedAt":"2026-09-10T15:24:29.095Z","normalizedAt":"2026-09-10T15:24:29.095Z"}]},"firstSeenAt":"2026-09-10T15:24:29.095Z","updatedAt":"2026-09-10T15:25:27.405Z"}