iMessage MCP Server

iMessage MCP 서버

⚠️ 면책 조항 - 사용 시 모든 위험은 사용자에게 있습니다. ⚠️

본 소프트웨어는 있는 그대로 제공되며, 어떠한 보증이나 보장 없이 제공됩니다.

AppleScript를 사용하여 iMessage를 보내고 연락처를 관리하는 MCP 서버입니다.

이 서버는 AppleScript를 사용하여 모델 컨텍스트 프로토콜(MCP)을 통해 macOS 메시지 및 연락처 앱과 상호 작용합니다. AppleScript 명령을 TypeScript 서버로 래핑하여 다음과 같은 작업을 수행할 수 있습니다.

• 연락처 보기 및 검색
• 연락처 또는 전화번호로 iMessage 보내기
• 메시지가 전송되면 확인을 받으세요

특징

자원

• contacts://all 클릭하세요.
• 이름, 전화번호, 이메일 주소를 포함한 연락처 세부 정보를 확인하세요.
• 모든 데이터는 귀하의 컴퓨터에 로컬로 저장됩니다.

도구

• search_contacts - 이름, 전화번호 또는 이메일로 연락처 찾기
  • 검색어를 입력하면 일치하는 연락처를 반환합니다.
  • 이름, 전화번호, 이메일 주소로 검색
• send_message - iMessage 보내기
  • 수신자(전화/이메일) 및 메시지 내용을 가져옵니다.
  • 로컬 메시지 앱을 통해 전송
  • 확인 또는 오류 세부 정보를 반환합니다.

설치

1. 종속성 설치:

지엑스피1

2. 서버를 빌드하세요:

3. Claude Desktop을 구성하여 서버를 사용합니다.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json

4. Claude Desktop을 다시 시작하세요
5. 메시지가 표시되면 권한을 부여하세요.
   • 연락처 접근
   • 메시지 접근

용법

설치가 완료되면 Claude Desktop과 자연스럽게 대화할 수 있습니다.

• "내 연락처 보여줘"
• "Marissa라는 이름의 연락처 검색"
• "555-0123으로 메시지를 보내서 10분 후에 도착한다고 전해주세요."
• 앨리스에게 점심 먹을 시간인지 물어보는 iMessage를 보내세요.

보안 참고 사항

• 모든 작업은 로컬 컴퓨터에서 수행됩니다.
• 연락처나 메시지 데이터는 외부 서버로 전송되지 않습니다.
• 서버에는 연락처 및 메시지 액세스를 위한 macOS 권한이 필요합니다.
• 메시지는 iMessage 계정을 통해 전송됩니다.

개발

개발 및 디버깅을 위해 MCP Inspector를 사용하세요.

요구 사항

• macOS(메시지 및 연락처 통합용)
• Node.js 18 이상
• 클로드 데스크탑
• 활성화된 iMessage 계정

문제 해결

메시지가 전송되지 않는 경우:

1. 메시지 앱이 로그인되어 있는지 확인하세요
2. 권한이 부여되었는지 확인하세요
3. Claude Desktop 로그에서 오류를 찾으세요.