Chatlog 是什么？

Chatlog是一个基于MCP实现聊天记录总结和查询的开源工具，它实现聊天记录总结与查询，完美解决群聊消息繁多、无暇查看的痛点。它操作界面友好，同时提供命令行工具，支持微信 3.x 和 4.0 版本，可查询聊天记录、联系人、群聊及最近对话等信息。借助 MCP SSE 协议，它能与 Claude、ChatWise、Cherry Studio 等支持 MCP 的 ai 助手无缝集成。，支持 Windows 和 macOS 系统。

Chatlog可以帮助用户

备份和查看微信聊天内容。

通过命令行或可视界面浏览聊天记录。

启动本地 HTTP 服务，方便用浏览器或 AI 助手访问。

与 AI 聊天助手（如 ChatWise）集成，调用微信数据。

Chatlog安装使用教程

准备工作

电脑端微信：

下载并安装最新版微信客户端（Windows 或 macOS 均可）。

聊天记录迁移到电脑：

打开手机微信，依次点击：我 → 设置 → 通用 → 聊天记录迁移与备份 → 迁移 → 迁移到电脑。

按提示操作，将手机里的聊天记录传输到电脑微信，这个过程不会删除手机上的聊天数据。

安装 Chatlog

1. 直接下载安装包：

打开 Chatlog Releases 页面。

根据你的系统（Windows 或 macOS）下载对应的预编译版本。

解压后得到 chatlog 可执行文件。

2. 源码安装（需要安装好 Go 环境）：

安装完成后，chatlog 会在 $GOPATH/bin 目录下。

macOS 用户特别注意

首次解密微信密钥时，需关闭 SIP（系统完整性保护）：

Intel Mac：按住 Command + R 开机进入恢复模式。

Apple Silicon：按住电源键进入恢复模式。

菜单栏：实用工具 → 终端。

输入命令：

重启系统。

关闭 SIP 后，建议安装 Xcode（从 App Store 下载）。

只在获取密钥时需要关闭 SIP，后续可以重新开启 SIP。

运行 Chatlog

1. 启动程序：

双击运行 chatlog，或者在命令行输入：

进入一个简单的终端界面，用方向键选择菜单，回车确认，Esc 返回，Ctrl+C 退出。

2. 获取密钥和解密数据库：

如果只想用命令行：

完成后，Chatlog 会自动加载微信数据。

启动 HTTP 服务

启动后，Chatlog 会自动开启一个本地 HTTP 服务（默认端口 5030），你可以用浏览器访问：

http://localhost:5030

或调用 API：

聊天记录：

GET /api/v1/chatlog?talker=wxid_xxx&limit=100

联系人列表：

GET /api/v1/contact

群聊列表：

GET /api/v1/chatroom

会话列表：

GET /api/v1/session

与 ChatWise 集成

Chatlog 支持 MCP SSE 协议，方便 AI 助手调用微信数据。

ChatWise 设置方法：

1. 打开 ChatWise → 设置 → 工具。

2. 新建工具，类型选择 sse。

3. 填写参数：

4. 勾选“自动执行工具”。

5. 保存即可。

chatlog应用场景

个人数据管理：用户可以轻松管理和查询自己的微信聊天记录，进行数据备份和分析。

AI 数据分析：通过 HTTP API 和 MCP SSE 协议，将聊天记录接入 AI 工具进行智能分析，如情感分析、主题建模等。

故障排查与性能监控：在开发环境中，可用于故障排查和性能监控。

日志分析与优化：分析聊天记录中的信息，为产品优化提供数据支持。

安全审计：跟踪敏感操作，及时发现和预防安全风险。

chatlog常见问题

1. 数据安全吗？

Chatlog 只在本地运行，数据不会上传云端。

2. 会破坏微信数据吗？

不会，Chatlog 是只读，不会更改微信数据库。

3. 支持多账号吗？

当前版本主要针对一个微信账号。

4. 支持多媒体文件吗？

暂不支持，未来版本会加入。