一、环境准备

1.Python 环境确认

安装链接： Python Install Manager - Windows官方下载 | 微软应用商店 | Microsoft Store

安装成功后，运行命令 python --version 出现版本号，就代表成功

2.版本要求

Python需要3.10以上，不然后续的过程可能会报错

我的测试环境是：

• Python 3.14.5
• 微信 4.x以上
• Windows操作系统

二、核心工具：wechat-decrypt

1.安装依赖

项目地址：https://github.com/ylytdeng/...

这个项目帮你一键解密微信数据库，并且自带一个 MCP 服务，可以直接把聊天记录喂给 AI。

# 1. 克隆项目
git clone https://github.com/ylytdeng/wechat-decrypt.git
cd wechat-decrypt
# 2. 安装依赖
pip install -r requirements.txt
# 3. (以管理员身份运行) 启动主程序，默认包含密钥提取、解密和Web服务
python main.py

运行 main.py，会打开一个网页，表示微信聊天记录已经拿到了

2.安装依赖，遇到报错（如果没有请跳过）

运行pip install -r requirements.txt我遇到报错：ERROR: Failed to build 'zstandard' when installing build dependencies for zstandard。

原因是 zstandard 的核心是用 C 语言写的，pip 默认会尝试从源码编译。报错，很可能就是因为你缺少了 Windows C++ 编译工具链。

方案一 ：尝试安装官方编译版

# 1.先安装wheel
pip install --upgrade pip wheel
# 2.安装zstandard 最新版本
pip install --only-binary=zstandard zstandard

如果这个命令成功了，那问题就解决了。如果依然失败，说明没有匹配你系统或 Python 版本的预编译包，我们再尝试方案二。

方案二：安装完整编译环境

1. 安装 Visual Studio Build Tools：访问 Microsoft C++ Build Tools 下载页面，下载并运行安装程序。勾选 “使用 C++ 的桌面开发” 即可，它是编译 zstandard 这些原生库的主力。

2. 更新 setuptools：安装完工具后，重启电脑确保环境变量生效。然后运行 pip install --upgrade setuptools 更新打包工具。

3. 重新安装 zstandard：最后再次执行 pip install zstandard，这次应该就能顺利编译安装了。

3.密钥提取失败（如果没有请跳过）

如果报错内容是「未能从任何微信进程中提取到密钥」，检查wechat-decrypt/config.json 文件

db_dir 是否 与微信聊天记录地址一致，如果没有，修改db_dir

三、将微信数据查询能力接入Claude Code，让AI直接读取你的微信消息

可以获得微信聊天记录以后，可以连接AI 大模型，分析你的聊天记录

注册：

claude mcp add wechat -- python /path/to/mcp_server.py

可用工具：

工具	功能
get_recent_sessions(limit)	最近会话列表
get_chat_history(chat_name, limit, offset, start_time, end_time)	聊天记录
search_messages(keyword, chat_name, limit, offset, ...)	搜索消息
get_contacts(query, limit)	联系人搜索
get_contact_tags()	联系人标签
get_voice_messages(chat_name)	语音消息列表
decode_voice(chat_name, local_id)	解码语音为 WAV
transcribe_voice(chat_name, local_id)	转录语音为文字

最后大功告成，放上一张图片