Skip to main content
Glama
carterlasalle

mac-messages-mcp

Mac 메시지 MCP

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

PyPI 다운로드

tex_FvvnmbaBTFeKy6F2GMlLqA_IfCBMgJARcia1WTH7FaqwA가 있는 Mac 컴퓨터의 다이어그램

특징

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

  • 연락처로 메시지 필터링

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

  • API를 통해 메시지에 접근

Related MCP server: iMCP

필수 조건

  • 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

기여하다

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

스타 역사

별 역사 차트

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/carterlasalle/mac_messages_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server