대본 기획 도우미▸ 
AI 앱 
AI 뉴스 Chatlog: MCP 기반으로 채팅 기록 요약 및 조회 기능을 제공하는 오픈소스 도구
小编 ·
Chatlog: MCP 기반으로 채팅 기록 요약 및 조회 기능을 제공하는 오픈소스 도구
Chatlog이란 무엇인가요?
Chatlog는 MCP를 기반으로 채팅 기록 요약 및 쿼리를 구현한 오픈소스 도구로, 채팅 기록 요약 및 쿼리 기능을 제공하여 그룹 채팅 메시지가 너무 많아 확인할 시간이 없는 문제를 완벽하게 해결해 줍니다. 사용자 친화적인 인터페이스를 갖추고 있으며, 동시에 명령줄 도구를 제공하여 WeChat 3.x 및 4.0 버전을 지원하고 채팅 기록, 연락처, 그룹 채팅 및 최근 대화 등의 정보를 쿼리할 수 있습니다. MCP SSE 프로토콜을 통해 Claude, ChatWise, Cherry Studio 등 MCP를 지원하는 AI 어시스턴트와 원활하게 통합됩니다. Windows 및 macOS 시스템을 지원합니다.
Chatlog가 사용자를 도와줄 수 있는 것
WeChat 채팅 내용 백업 및 조회.
명령줄 또는 시각적 인터페이스를 통한 채팅 기록 탐색.
로컬 HTTP 서비스 시작으로 브라우저 또는 AI 어시스턴트를 통한 접근 지원.
AI 채팅 어시스턴트(예: ChatWise)와 통합하여 WeChat 데이터 호출.
Chatlog 설치 및 사용 튜토리얼
사전 준비
PC용 WeChat:
최신 버전의 WeChat 클라이언트를 다운로드하여 설치합니다(Windows 또는 macOS 모두 가능).
채팅 기록을 PC로 이전:
휴대폰 WeChat을 열고, 순서대로 클릭: 나 → 설정 → 일반 → 채팅 기록 이전 및 백업 → 이전 → PC로 이전.
안내에 따라 휴대폰의 채팅 기록을 PC용 WeChat으로 전송합니다. 이 과정에서 휴대폰의 채팅 데이터는 삭제되지 않습니다.
Chatlog 설치
1. 설치 패키지 직접 다운로드:
Chatlog Releases 페이지를 엽니다.
사용자의 시스템(Windows 또는 macOS)에 따라 해당 사전 컴파일 버전을 다운로드합니다.
압축을 해제하면 chatlog 실행 파일이 생성됩니다.
2. 소스 코드 설치(Go 환경 설치 필요):
go install github.com/sjzar/chatlog@latest
설치가 완료되면 chatlog는 $GOPATH/bin 디렉터리에 위치합니다.
macOS 사용자 특별 안내
WeChat 키를 처음 복호화할 때 SIP(시스템 무결성 보호)를 비활성화해야 합니다:
Intel Mac: Command + R을 누른 채로 부팅하여 복구 모드에 진입합니다.
Apple Silicon: 전원 버튼을 길게 눌러 복구 모드에 진입합니다.
메뉴 바: 유틸리티 → 터미널.
명령어 입력:
csrutil disable
시스템을 재부팅합니다.
SIP를 비활성화한 후 Xcode 설치(App Store에서 다운로드)를 권장합니다.
키를 가져올 때만 SIP를 비활성화하면 되며, 이후 다시 SIP를 활성화할 수 있습니다.
Chatlog 실행
1. 프로그램 시작:
chatlog를 더블 클릭하여 실행하거나, 명령줄에 입력:
./chatlog
간단한 터미널 인터페이스가 나타나며, 방향키로 메뉴를 선택하고 엔터로 확인, Esc로 돌아가기, Ctrl+C로 종료합니다.
2. 키 가져오기 및 데이터베이스 복호화:
명령줄만 사용하려면:
# WeChat 키 가져오기 ./chatlog key # 데이터베이스 복호화 ./chatlog decrypt
완료되면 Chatlog가 자동으로 WeChat 데이터를 로드합니다.
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 어시스턴트가 WeChat 데이터를 편리하게 호출할 수 있습니다.
ChatWise 설정 방법:
1. ChatWise → 설정 → 도구 열기.
2. 새 도구를 만들고 유형으로 sse를 선택합니다.
3. 매개변수 입력:
{
"id": "chatlog",
"type": "sse",
"url": "http://127.0.0.1:5030/sse",
"autoRun": true
}4. "도구 자동 실행"을 체크합니다.
5. 저장합니다.
chatlog 활용 시나리오
개인 데이터 관리: 사용자가 자신의 WeChat 채팅 기록을 손쉽게 관리 및 쿼리하고, 데이터 백업 및 분석을 수행할 수 있습니다.
AI 데이터 분석: HTTP API 및 MCP SSE 프로토콜을 통해 채팅 기록을 AI 도구에 연결하여 감성 분석, 주제 모델링 등 지능형 분석 수행.
장애排查 및 성능 모니터링: 개발 환경에서 장애排查 및 성능 모니터링에 사용 가능.
로그 분석 및 최적화: 채팅 기록의 정보를 분석하여 제품 최적화를 위한 데이터 지원 제공.
보안 감사: 민감한 작업을 추적하여 보안 위험을 적시에 발견하고 예방.
chatlog 자주 묻는 질문
1. 데이터는 안전한가요?
Chatlog는 로컬에서만 실행되며, 데이터는 클라우드로 업로드되지 않습니다.
2. WeChat 데이터가 손상되나요?
아니요, Chatlog는 읽기 전용이며 WeChat 데이터베이스를 변경하지 않습니다.
3. 여러 계정을 지원하나요?
현재 버전은 주로 하나의 WeChat 계정을 대상으로 합니다.
4. 멀티미디어 파일을 지원하나요?
현재는 지원하지 않으며, 향후 버전에서 추가될 예정입니다.
