imessage-query-fastmcp-mcp-server

iMessage 쿼리 MCP 서버

모델 컨텍스트 프로토콜(MCP)을 통해 iMessage 데이터베이스에 안전하게 액세스할 수 있도록 하는 MCP 서버입니다. 이 서버는 FastMCP 프레임워크와 imessagedb 라이브러리를 기반으로 구축되어 LLM이 전화번호 유효성 검사 및 첨부 파일 처리를 통해 iMessage 대화를 쿼리하고 분석할 수 있도록 지원합니다.

📋 시스템 요구 사항

• macOS(iMessage 데이터베이스 액세스에 필요)
• 파이썬 3.6 이상

📦 종속성

필요한 모든 종속성을 설치하세요:

지엑스피1

필수 패키지

• fastmcp : 모델 컨텍스트 프로토콜 서버를 구축하기 위한 프레임워크
• imessagedb : macOS 메시지 데이터베이스에 액세스하고 쿼리하기 위한 Python 라이브러리
• 전화번호 : 적절한 숫자 검증 및 형식 지정을 위한 Google의 전화번호 처리 라이브러리

모든 종속성은 requirements.txt 에 지정되어 있어 쉽게 설치할 수 있습니다.

📑 목차

• 시스템 요구 사항
• 종속성
• MCP 도구
• 시작하기
• 설치 옵션
  • 클로드 데스크탑
  • 클라인 VSCode 플러그인
• 안전 기능
• 개발 문서
• 환경 변수

🛠️ MCP 도구

서버는 LLM에 다음 도구를 제공합니다.

채팅 기록 받기

날짜 필터링을 선택하여 특정 전화번호의 메시지 기록을 검색합니다. 다음이 포함됩니다.

• 메시지 텍스트 및 타임스탬프
• 첨부 정보(있는 경우)
• 전화번호의 정확한 검증
• 날짜 범위 필터링

🚀 시작하기

저장소를 복제합니다.

📦 설치 옵션

이 MCP 서버는 Claude Desktop 또는 Cline VSCode 플러그인에 설치할 수 있습니다. 필요에 가장 적합한 옵션을 선택하세요.

옵션 1: Claude Desktop용 설치

FastMCP를 사용하여 설치:

옵션 2: Cline VSCode 플러그인 설치

이 서버를 Cline VSCode 플러그인 과 함께 사용하려면:

1. VSCode에서 Cline 플러그인 사이드바의 서버 아이콘(☰)을 클릭합니다.
2. "MCP 설정 편집" 버튼을 클릭하세요(✎)
3. 설정 파일에 다음 구성을 추가합니다.

/path/to/repo 이 저장소를 복제한 전체 경로로 바꾸세요(예: /Users/username/Projects/imessage-query-fastmcp-mcp-server )

🔒 안전 기능

• iMessage 데이터베이스에 대한 읽기 전용 액세스
• phonenumbers 라이브러리를 사용한 전화번호 검증
• 누락된 파일 감지를 통한 안전한 첨부 파일 처리
• 날짜 범위 검증
• 깨끗한 JSON 응답을 위한 진행 출력 억제

📚 개발 문서

저장소에는 개발을 위한 문서 파일이 포함되어 있습니다.

• dev_docs/imessagedb-documentation.txt : iMessage 데이터베이스 구조와 imessagedb 라이브러리 기능에 대한 포괄적인 설명서가 포함되어 있습니다.

이 문서는 기능을 개발할 때 맥락으로 활용되며 LLM과 함께 사용하여 개발을 지원할 수 있습니다.

⚙️ 환경 변수

서버가 자동으로 기본 macOS 위치에서 iMessage 데이터베이스를 찾으므로 환경 변수가 필요하지 않습니다.