local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows reading and sending messages through the macOS Messages app, with capabilities to filter messages by contact and interact with iMessage conversations.
Provides access to the macOS Messages database, enabling interaction with the native messaging system on Mac computers.

Mac 메시지 MCP

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

특징

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

필수 조건

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

UV 설치

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

지엑스피1

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

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

설치

전체 디스크 액세스 권한

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

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

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

완성

Claude 데스크톱 통합

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

{
    "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

기여하다

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

MCP(Multiple Context Protocol)를 사용하여 macOS 메시지 앱과 상호 작용하기 위한 Python 브릿지입니다. uvx mac-messages-mcp를 사용하여 간단히 설치하세요.

Related Resources

Reddit Discussion about this server