一、chatlog 使用详解
chatlog 是一个聊天记录工具项目,可以获取、总结微信的聊天记录
一)概述
功能目标:提供便捷的方式从本地数据库文件获取聊天数据,支持多系统、多版本微信,具备多种使用方式和功能特性。
适用范围:支持 Windows 和 macOS 系统,适用于微信 3.x 和 4.0 版本。
数据获取:能够从本地数据库文件获取聊天数据。
系统与版本支持:支持 Windows 和 macOS 系统,兼容微信 3.x 和 4.0 版本。
用户界面:提供 Terminal UI 界面和命令行工具,方便不同用户使用。
API 服务:提供 HTTP API 服务,可用于查询聊天记录、联系人、群聊、最近会话等信息。
协议集成:支持 MCP SSE 协议,可与支持 MCP 的 AI 助手无缝集成。
多媒体支持:支持多媒体消息,能够解密图片、语音。
自动解密:支持自动解密数据,简化使用流程。
多账号管理:支持多账号管理,可在不同账号间切换。
二)下载
开源仓库下载链接:github.com/sjzar/chatl...
Mac 选择第 2 个、windows 选择第 3 个

安装包下载完成后,打开对应的文件夹
三)安装
macOS 电脑在获取密钥前需要临时关闭 SIP(系统完整性保护),进入恢复模式。
关闭 SIP,关机重启,重启时长按电源键,直到出现正在载入启动选项

成功进入恢复模式,选择选项,点击继续

在右上角找到终端

打开终端
vbnet
输入 csrutil disable,回车
接着输入电脑的密码,再回车
接着输入 y,等待出现 System Integrity Protection is off 就说明进入恢复模式成功了

四)操作 chatlog
找到我们刚刚下载的安装包打开

打开 chatlog 后,我们需要先获取数据密钥,键盘⬆️⬇️键可以移动,然后回车即可

选择获取数据密钥,回车

显示获取数据密钥成功

再依次选择 解密数据、启动 HTTP 服务,然后回车,等全部流程走完,就算启动成功了
五)API 访问
启动 HTTP 服务后(默认地址 http://127.0.0.1:5030
),可通过以下 API 访问数据。
聊天记录查询:GET /api/v1/chatlog?time=2023-01-01&talker=wxid_xxx
bash
参数说明:time: 时间范围,格式为 YYYY-MM-DD 或 YYYY-MM-DD~YYYY-MM-DD
talker: 聊天对象标识(支持 wxid、群聊 ID、备注名、昵称等)
limit: 返回记录数量
offset: 分页偏移量
format: 输出格式,支持 json、csv 或纯文本
其他 API 接口
联系人列表:GET /api/v1/contact
群聊列表:GET /api/v1/chatroom
会话列表:GET /api/v1/session
多媒体内容
聊天记录中的多媒体内容会通过 HTTP 服务进行提供,可通过以下路径访问:
图片内容:GET /image/<id>
视频内容:GET /video/<id>
文件内容:GET /file/<id>
语音内容:GET /voice/<id>
多媒体内容:GET /data/<data dir relative path>
二、MCP 快捷使用
一)Cursor 配置 MCP
sql
打开 Cursor 右上角设置
选择 MCP
点击 Add new global MCP server 添加 MCP

打开 mcp.json 文件,把下面这段复制进去
json
"mcpServers": {
"chatlog": {
"url": "http://127.0.0.1:5030/sse"
},
}
二)测试使用
打开 Cursor 的 Chat 对话框,直接自然语言对话。
1、查询微信有多少个群和好友

2、查询某个联系人的信息

3、查询总结群的精华
提示词:
markdown
talker:群名称
Time:聊天时间
你是一个中文的群聊总结的助手,你可以为一个微信的群聊记录,提取并总结每个时间段大家在重点讨论的话题内容。
请帮我将 "<talker>" 在 <Time> 的群聊内容总结成一个群聊报告,包含不多于5个的话题的总结(如果还有更多话题,可以在后面简单补充)。每个话题包含以下内容:
- 话题名(50字以内,带序号1️⃣2️⃣3️⃣,同时附带热度,以🔥数量表示)
- 参与者(不超过5个人,将重复的人名去重)
- 时间段(从几点到几点)
- 过程(50到200字左右)
- 评价(50字以下)
- 分割线: ------------
另外有以下要求:
1. 每个话题结束使用 ------------ 分割
2. 使用中文冒号
3. 无需大标题
4. 开始给出本群讨论风格的整体评价,例如活跃、太水、太黄、太暴力、话题不集中、无聊诸如此类
最后总结下最活跃的前五个发言者。

结合 MCP 的可玩性还很高,输入群聊一键总结精华消息,不用再爬楼了~