Mac 메시지 MCP

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

특징

• macOS 메시지 앱에서 최근 메시지 읽기

• 연락처로 메시지 필터링

• iMessage를 통해 새 메시지 보내기

• API를 통해 메시지에 접근

Related MCP server: MCP Python Server

필수 조건

• 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. 다음 구성을 추가합니다.

{
    "mcpServers": {
        "messages": {
            "command": "uvx",
            "args": [
                "mac-messages-mcp"
            ]
        }
    }
}

커서 통합

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

uvx mac-messages-mcp

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

옵션 1: PyPI에서 설치

uv pip install mac-messages-mcp

옵션 2: 소스에서 설치

# Clone the repository
git clone https://github.com/carterlasalle/mac_messages_mcp.git
cd mac_messages_mcp

# Install dependencies
uv install -e .

용법

모듈로서

from mac_messages_mcp import get_recent_messages, send_message

# Get recent messages
messages = get_recent_messages(hours=48)
print(messages)

# Send a message
result = send_message(recipient="+1234567890", message="Hello from Mac Messages MCP!")
print(result)

명령줄 도구로

# Run the MCP server directly
mac-messages-mcp

개발

버전 관리

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

버전을 높이려면:

python scripts/bump_version.py [patch|minor|major]

보안 참고 사항

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

특허

MIT

기여하다

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

스타 역사