chatlog:一个基于MCP实现聊天记录总结和查询的开源工具
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 环境):
go install github.com/sjzar/chatlog@latest
安装完成后,chatlog 会在 $GOPATH/bin 目录下。
macOS 用户特别注意
首次解密微信密钥时,需关闭 SIP(系统完整性保护):
Intel Mac:按住 Command + R 开机进入恢复模式。
Apple Silicon:按住电源键进入恢复模式。
菜单栏:实用工具 → 终端。
输入命令:
csrutil disable
重启系统。
关闭 SIP 后,建议安装 Xcode(从 App Store 下载)。
只在获取密钥时需要关闭 SIP,后续可以重新开启 SIP。
运行 Chatlog
1. 启动程序:
双击运行 chatlog,或者在命令行输入:
./chatlog
进入一个简单的终端界面,用方向键选择菜单,回车确认,Esc 返回,Ctrl+C 退出。
2. 获取密钥和解密数据库:
如果只想用命令行:
# 获取微信密钥 ./chatlog key # 解密数据库 ./chatlog decrypt
完成后,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. 填写参数:
{ "id": "chatlog", "type": "sse", "url": "http://127.0.0.1:5030/sse", "autoRun": true }
4. 勾选“自动执行工具”。
5. 保存即可。
chatlog应用场景
个人数据管理:用户可以轻松管理和查询自己的微信聊天记录,进行数据备份和分析。
AI 数据分析:通过 HTTP API 和 MCP SSE 协议,将聊天记录接入 AI 工具进行智能分析,如情感分析、主题建模等。
故障排查与性能监控:在开发环境中,可用于故障排查和性能监控。
日志分析与优化:分析聊天记录中的信息,为产品优化提供数据支持。
安全审计:跟踪敏感操作,及时发现和预防安全风险。
chatlog常见问题
1. 数据安全吗?
Chatlog 只在本地运行,数据不会上传云端。
2. 会破坏微信数据吗?
不会,Chatlog 是只读,不会更改微信数据库。
3. 支持多账号吗?
当前版本主要针对一个微信账号。
4. 支持多媒体文件吗?
暂不支持,未来版本会加入。