iMessage MCP

로컬 iMessage 데이터베이스를 읽고 macOS에서 Messages.app을 통해 메시지를 보내는 MCP 서버입니다.

이 서버는 로컬 사용에서는 stdio로, 원격 사용에서는 HTTP로 실행되므로, 휴대폰이나 태블릿이 노트북이 사용하는 것과 동일한 서버에 접속할 수 있습니다. 이것이 이 프로젝트의 핵심입니다. 데스크톱 전용 iMessage 통합은 잘 작동하지만, 데스크톱은 잘못된 장소입니다 — 조치할 가치가 있는 메시지는 데스크톱을 떠나 있을 때 도착하기 때문입니다.

상태

초기 단계입니다. 읽기 계층은 구축 중이며, HTTP 전송, 인증, 배포는 아직 작성되지 않았습니다. 설계, 설계의 기반이 된 측정값, 그리고 의도적으로 미루어진 항목은 docs/scope.md를 참조하세요.

Related MCP server: iMessage MCP Server

요구 사항

• Messages에 로그인된 macOS

• Python 3.12+ 및 uv

• ~/Library/Messages/chat.db를 읽기 위한 Python 인터프리터의 전체 디스크 접근 권한(메시지 Full Disk Access)

메시지 전송에는 Messages를 제어할 권한이 추가로 필요하며, macOS는 첫 메시지를 보낼 때 이 권한을 요청합니다.

개발

uv sync --extra test
uv run pytest

테스트 스위트는 오프라인으로 실행되며, Apple의 스키마로 구축된 합성 데이터베이스를 대상으로 동작합니다. 실제 데이터베이스는 절대 열지 않으므로, iMessage를 한 번도 보낸 적 없는 컴퓨터에서도 작동합니다.

라이선스

MIT