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. 支持多媒體文件嗎?
暫不支持,未來版本會加入。