iMessage 쿼리 MCP 서버

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

📋 시스템 요구 사항

• macOS(iMessage 데이터베이스 액세스에 필요)

• 파이썬 3.6 이상

Related MCP server: MySQL MCP Server

📦 종속성

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

지엑스피1

필수 패키지

• fastmcp : 모델 컨텍스트 프로토콜 서버를 구축하기 위한 프레임워크

• imessagedb : macOS 메시지 데이터베이스에 액세스하고 쿼리하기 위한 Python 라이브러리

• 전화번호 : 적절한 숫자 검증 및 형식 지정을 위한 Google의 전화번호 처리 라이브러리

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

📑 목차

• 시스템 요구 사항

• 종속성

• MCP 도구

• 시작하기

• 설치 옵션

  • 클로드 데스크탑

  • 클라인 VSCode 플러그인

• 안전 기능

• 개발 문서

• 환경 변수

🛠️ MCP 도구

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

채팅 기록 받기

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

• 메시지 텍스트 및 타임스탬프

• 첨부 정보(있는 경우)

• 전화번호의 정확한 검증

• 날짜 범위 필터링

🚀 시작하기

저장소를 복제합니다.

git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git
cd imessage-query-fastmcp-mcp-server

📦 설치 옵션

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

옵션 1: Claude Desktop용 설치

FastMCP를 사용하여 설치:

fastmcp install imessage-query-server.py --name "iMessage Query"

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

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

1. VSCode에서 Cline 플러그인 사이드바의 서버 아이콘(☰)을 클릭합니다.

2. "MCP 설정 편집" 버튼을 클릭하세요(✎)

3. 설정 파일에 다음 구성을 추가합니다.

{
  "imessage-query": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "fastmcp",
      "fastmcp",
      "run",
      "/path/to/repo/imessage-query-server.py"
    ]
  }
}

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

🔒 안전 기능

• iMessage 데이터베이스에 대한 읽기 전용 액세스

• phonenumbers 라이브러리를 사용한 전화번호 검증

• 누락된 파일 감지를 통한 안전한 첨부 파일 처리

• 날짜 범위 검증

• 깨끗한 JSON 응답을 위한 진행 출력 억제

📚 개발 문서

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

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

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

⚙️ 환경 변수

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