carterlasalle/mac_messages_mcp

An MCP server that securely interfaces with your iMessage database via the Model Context Protocol (MCP), allowing LLMs to query and analyze iMessage conversations. It includes robust phone number validation, attachment processing, contact management, group chat handling, and full support for sending and receiving messages.

해결하는 문제

Mac Messages MCP는 AI 에이전트가 (Model Context Protocol을 통해) macOS 메시지 앱과 상호 작용할 수 있도록 합니다. 이를 통해 LLM은 iMessage, SMS, RCS 메시지를 읽고, 검색하고, 보내며 연락처를 관리할 수 있으며, 이 모든 작업은 사용자의 Mac에서 로컬로 실행됩니다.

작동 원리

이 서버는 로컬 macOS의 chat.db 및 AddressBook 데이터베이스에 읽기 전용 모드로 연결하여 메시지 기록과 연락처 세부 정보를 검색합니다. 메시지를 보내기 위해 AppleScript를 사용하여 Messages.app을 자동화합니다. 또한 메시지에서 파생된 텍스트를 "신뢰할 수 없음"으로 레이블을 지정하는 구조적 경계를 구현하여 AI 모델이 외부 메시지 내용을 시스템 명령으로 오해하는 것을 방지합니다.

대상 사용자

AI 어시스턴트가 macOS 통신을 관리할 수 있기를 원하는 MCP 호환 클라이언트(Claude Desktop, Cursor, VS Code, Codex 등) 사용자.

주요 특징

  • 포괄적인 메시징: 최근 메시지 읽기, 메시지 본문 퍼지 검색, 1:1 및 그룹 채팅 목록 표시를 지원합니다.
  • 첨부 파일 처리: 첨부 파일 메타데이터 및 내용(텍스트/PDF)을 검색하고 이미지(HEIC를 PNG로 변환) 또는 더 큰 파일에 대한 로컬 경로를 반환할 수 있습니다.
  • 전송 기능: SMS/RCS 폴백을 통한 메시지 전송을 지원하며, 나중에 전송할 메시지 예약(서버 프로세스가 활성화된 동안)을 지원합니다.
  • 연락처 관리: 퍼지 연락처 조회 및 새 연락처 항목 생성 기능을 포함합니다.
  • 보안 우선 설계: 읽기 전용 데이터베이스 액세스 및 출력의 구조적 중립화를 사용하여 외부 메시지로 인한 프롬프트 인젝션 위험을 완화합니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트