mac-messages-mcp

Mac 메시지 MCP

MCP(Multiple Context Protocol)를 사용하여 macOS 메시지 앱과 상호작용하기 위한 Python 브리지입니다.

특징

• macOS 메시지 앱에서 최근 메시지 읽기
• 연락처로 메시지 필터링
• iMessage를 통해 새 메시지 보내기
• API를 통해 메시지에 접근

필수 조건

• macOS(macOS 11 이상에서 테스트됨)
• 파이썬 3.10+
• uv 패키지 관리자

UV 설치

Mac을 사용하는 경우 Homebrew를 사용하여 uv를 설치하세요.

지엑스피1

그렇지 않은 경우, uv 웹사이트 의 설치 지침을 따르세요.

⚠️ UV 설치 전 진행하지 마세요

설치

전체 디스크 액세스 권한

⚠️ 이 애플리케이션은 터미널이나 애플리케이션이 메시지 데이터베이스에 접근하기 위해 전체 디스크 접근 권한이 필요합니다.

전체 디스크 액세스 권한을 부여하려면:

1. 시스템 환경 설정/설정 > 보안 및 개인 정보 보호/개인 정보 보호 > 전체 디스크 액세스를 엽니다.
2. 변경하려면 잠금 아이콘을 클릭하세요.
3. 터미널 앱(Terminal, iTerm2 등) 또는 Claude Desktop/Cursor를 목록에 추가하세요.
4. 권한을 부여한 후 터미널이나 애플리케이션을 다시 시작하세요.

완성

Claude 데스크톱 통합

1. Claude > 설정 > 개발자 > 구성 편집 > claude_desktop_config.json 으로 이동하세요.
2. 다음 구성을 추가합니다.

커서 통합

커서 설정 > MCP 로 이동하여 다음 명령을 붙여넣습니다.

⚠️ MCP 서버 인스턴스를 하나만 실행하세요(Cursor 또는 Claude Desktop에서 실행). 둘 다 실행하지 마세요.

옵션 1: PyPI에서 설치

옵션 2: 소스에서 설치

용법

모듈로서

명령줄 도구로

개발

버전 관리

이 프로젝트에서는 의미적 버전 관리를 사용합니다. 버전 관리 시스템의 작동 방식과 새 버전을 출시하는 방법에 대한 자세한 내용은 VERSIONING.md를 참조하세요.

버전을 높이려면:

보안 참고 사항

이 애플리케이션은 개인 통신 내용이 포함된 메시지 데이터베이스에 직접 접근합니다. 책임감 있게 사용하고 적절한 권한을 부여받았는지 확인하세요.

특허

MIT

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

스타 역사