mattt/iMCP

A macOS app that provides an MCP server to your Messages, Contacts, Reminders and more

iMCP – macOS 브리지: 개인 데이터와 AI 도구 사이의 연결

이것이 무엇인가

  • 네이티브 macOS 애플리케이션(번들 CLI 서버 포함)으로, Mac에 있는 데이터와 서비스(캘린더, 연락처, 메시지, 전화, 음성 메일, 미리 알림, 날씨, 위치, HomeKit 등)를 Model Context Protocol(MCP)을 통해 노출합니다.
  • Claude Desktop, Claude Code, Cursor, Amp와 같은 MCP 호환 AI 클라이언트는 이러한 서비스를 도구로 호출할 수 있어, LLM이 개인 정보를 수동으로 붙여넣지 않아도 검색하거나 조치를 취할 수 있습니다.

주요 기능

서비스 수행 가능 작업
캘린더 이벤트 나열, 생성, 수정(반복, 알람, 가용성).
연락처 자신의 연락처 카드 조회 또는 이름, 전화, 이메일로 연락처 검색.
홈 HomeKit 액세서리 검색, 특성 읽기/쓰기, 장면 및 자동화 실행(직접 서명해야 하는 별도 헬퍼 앱 필요).
위치/지도 현재 GPS 확인, 주소 변환, 장소 검색, 경로 요청, 이동 시간 예상, 정적 지도 이미지.
메시지 선택한 날짜 범위에서 참가자와의 메시지 기록 읽기.
전화 통화 기록 보기, 연락처/날짜/유형으로 필터링, 통화 시작(macOS 확인 필요).
음성 메일 동기화된 음성 메일 검색(전사 및 오디오 포함), 발신자/사서함으로 필터링.
미리 알림 미리 알림 나열, 생성, 편집, 삭제 및 미리 알림 목록 관리.
단축어 macOS 단축어 나열 및 실행, 선택적으로 텍스트 입력 전달.
날씨 모든 위치의 현재 온도, 바람, 상태.

작동 방식

  1. MCP 서버 – 앱은 표준 I/O를 통해 MCP를 사용하는 명령줄 실행 파일 imcp-server를 번들로 포함합니다.
  2. 검색 – 앱과 서버는 Bonjour를 통해 _mcp._tcp 서비스를 광고하므로, 같은 Mac에 있는 모든 MCP 클라이언트가 자동으로 찾을 수 있습니다.
  3. 권한 처리 – 서비스를 활성화하면 macOS가 일반적인 권한 대화상자(예: 캘린더 전체 접근)를 표시합니다. 앱은 부여된 샌드박스 접근 권한(메시지, 통화 기록, 음성 메일 등에 대한 폴더 선택)을 저장하고 이를 사용하여 기본 SQLite 데이터베이스를 읽습니다.
  4. 데이터 형식 – 도구 결과는 Schema.org 어휘를 사용하는 JSON-LD로 반환됩니다(예: 연락처는 Person 객체가 됨). 이렇게 하면 LLM 및 기타 소프트웨어가 출력을 쉽게 사용할 수 있습니다.
  5. HomeKit 지원 – HomeKit은 Mac Catalyst 앱에서만 사용할 수 있으므로, iMCP는 별도의 iMCP Helper를 제공하며, 이를 직접 Apple 개발자 계정으로 빌드하고 서명해야 합니다. 기본 앱은 로컬 TCP 포트를 통해 헬퍼와 통신합니다.

설치

  • https://iMCP.app/download 에서 서명된 앱 다운로드(macOS 15.3+ 필요), 또는 Homebrew로 설치:
    brew install --cask mattt/tap/iMCP
  • 앱은 메뉴 바에 아이콘을 배치합니다. 파란색 스위치를 켜서 MCP 서버를 시작하세요.
  • 필요한 서비스를 활성화하면 각각 적절한 macOS 권한을 요청합니다.
  • (선택 사항) 홈 자동화를 원하면 HomeKit 헬퍼를 빌드하세요:
    git clone https://github.com/mattt/iMCP.git
cd iMCP
Scripts/install-helper.sh   # 헬퍼를 서명하고 설치합니다

AI 클라이언트 연결

  • Claude Desktop – 설정 → 개발자 → 구성 편집을 열고, iMCP의 Claude Desktop 구성 메뉴 항목을 사용하세요. 이렇게 하면 claude_desktop_config.json에 서버 항목이 작성됩니다. Claude를 다시 시작하면 도구 목록에 망치 아이콘(🔨)과 함께 12개의 iMCP 도구가 표시됩니다.
  • Claude Code, Cursor, Amp – 각각 iMCP 서버를 전역으로 등록하는 CLI 명령(claude mcp add …, cursor …, amp mcp add …)을 제공합니다. Cursor에는 딥링크 URL도 제공됩니다.

디버깅 및 검사

  • 로컬 네트워크 권한 – imcp-server는 로컬 네트워크 개인정보 보호 권한이 필요합니다. 시스템 설정 > 개인정보 및 보안에서 활성화하세요.
  • MCP Inspector – npx @modelcontextprotocol/inspector <server-command>를 실행하여 클라이언트와 iMCP 간의 모든 요청/응답을 보여주는 웹 UI를 엽니다.
  • Companion – 서버의 프롬프트, 리소스, 도구를 대화형으로 탐색하는 macOS 15+ 유틸리티.

대상 사용자

  • AI 강화 macOS 경험을 구축하는 개발자로서 개인 데이터를 LLM에 안전하고 프라이버시 우선 방식으로 노출해야 하는 경우.
  • AI 어시스턴트(Claude, Cursor 등)가 데이터를 수동으로 복사하지 않고도 "지금 내 위치의 날씨는?" 또는 "다음 주 화요일 오후 3시에 Alice와 회의를 예약해줘" 같은 질문에 답변하길 원하는 고급 사용자.
  • Model Context Protocol에 관심이 있는 모든 사람; iMCP는 참조 구현 역할을 하며 공식 Swift SDK for MCP를 제공합니다.

작동 방식

  1. MCP 서버 – 앱은 표준 I/O를 통해 MCP를 사용하는 명령줄 실행 파일 imcp-server를 번들로 포함합니다.
  2. 검색 – 앱과 서버는 Bonjour를 통해 _mcp._tcp 서비스를 광고하므로, 동일한 Mac의 모든 MCP 클라이언트가 자동으로 찾을 수 있습니다.
  3. 권한 처리 – 서비스를 활성화하면 macOS가 일반적인 권한 대화상자(예: 캘린더 전체 접근)를 표시합니다. 앱은 부여된 샌드박스 접근(메시지, 통화 기록, 음성 메일 등에 대한 폴더 선택)을 저장하고 이를 사용하여 기본 SQLite 데이터베이스를 읽습니다.
  4. 데이터 형식 – 도구 결과는 Schema.org 어휘를 사용하는 JSON-LD로 반환됩니다(예: 연락처는 Person 객체가 됨). 이렇게 하면 LLM 및 기타 소프트웨어가 출력을 쉽게 사용할 수 있습니다.
  5. HomeKit 지원 – HomeKit은 Mac Catalyst 앱에서만 사용할 수 있으므로, iMCP는 별도의 iMCP Helper를 제공하며, 이를 직접 Apple 개발자 계정으로 빌드하고 서명해야 합니다. 기본 앱은 로컬 TCP 포트를 통해 헬퍼와 통신합니다.

설치

  • https://iMCP.app/download 에서 서명된 앱 다운로드(macOS 15.3+ 필요), 또는 Homebrew로 설치:
    brew install --cask mattt/tap/iMCP
  • 앱은 메뉴 바에 아이콘을 배치합니다. 파란색 스위치를 켜서 MCP 서버를 시작하세요.
  • 필요한 서비스를 활성화하세요. 각 서비스는 적절한 macOS 권한을 요청합니다.
  • (선택 사항) 홈 자동화를 원하면 HomeKit 헬퍼를 빌드하세요:
    git clone https://github.com/mattt/iMCP.git
cd iMCP
Scripts/install-helper.sh   # 헬퍼를 서명하고 설치합니다

AI 클라이언트 연결

  • Claude Desktop – 설정 → 개발자 → 구성 편집을 열고, iMCP의 Claude Desktop 구성 메뉴 항목을 사용하세요. 이렇게 하면 claude_desktop_config.json에 서버 항목이 기록됩니다. Claude를 재시작하면 도구 목록에 망치 아이콘(🔨)과 함께 12개의 iMCP 도구가 표시됩니다.
  • Claude Code, Cursor, Amp – 각각 iMCP 서버를 전역으로 등록하는 CLI 명령(claude mcp add …, cursor …, amp mcp add …)을 제공합니다. Cursor에는 딥링크 URL도 제공됩니다.

디버깅 및 검사

  • 로컬 네트워크 권한 – imcp-server는 로컬 네트워크 개인 정보 보호 권한이 필요합니다. 시스템 설정 > 개인 정보 보호 및 보안에서 활성화하세요.
  • MCP Inspector – npx @modelcontextprotocol/inspector <server-command>를 실행하여 클라이언트와 iMCP 간의 모든 요청/응답을 보여주는 웹 UI를 엽니다.
  • Companion – 서버의 프롬프트, 리소스, 도구를 대화형으로 탐색하는 macOS 15+ 유틸리티.

대상 사용자

  • AI 강화 macOS 경험을 구축하는 개발자로서, 개인 데이터를 LLM에 노출하는 안전하고 프라이버시 우선 방식을 필요로 하는 경우.
  • AI 어시스턴트(Claude, Cursor 등)가 데이터를 수동으로 복사하지 않고도 "지금 내 위치의 날씨는?" 또는 "다음 주 화요일 오후 3시에 Alice와 회의를 예약해줘" 같은 질문에 답변하길 원하는 파워 유저.
  • Model Context Protocol에 관심이 있는 모든 사람; iMCP는 참조 구현 역할을 하며 공식 Swift SDK for MCP를 제공합니다.

작동 방식

  1. MCP 서버 – 앱은 표준 I/O를 통해 MCP를 사용하는 명령줄 실행 파일 imcp-server를 번들로 포함합니다.
  2. 검색 – 앱과 서버는 Bonjour를 통해 _mcp._tcp 서비스를 광고하므로, 같은 Mac에 있는 모든 MCP 클라이언트가 자동으로 찾을 수 있습니다.
  3. 권한 처리 – 서비스를 활성화하면 macOS가 일반적인 권한 대화상자(예: 캘린더 전체 접근)를 표시합니다. 앱은 부여된 샌드박스 접근 권한(메시지, 통화 기록, 음성 메일 등에 대한 폴더 선택)을 저장하고 이를 사용하여 기본 SQLite 데이터베이스를 읽습니다.
  4. 데이터 형식 – 도구 결과는 Schema.org 어휘를 사용하는 JSON-LD로 반환됩니다(예: 연락처는 Person 객체가 됨). 이렇게 하면 LLM 및 기타 소프트웨어가 출력을 쉽게 사용할 수 있습니다.
  5. HomeKit 지원 – HomeKit은 Mac Catalyst 앱에서만 사용할 수 있으므로, iMCP는 자체 Apple Developer 계정으로 빌드하고 서명해야 하는 별도의 iMCP Helper를 제공합니다. 기본 앱은 로컬 TCP 포트를 통해 헬퍼와 통신합니다.

설치

  • https://iMCP.app/download 에서 서명된 앱 다운로드(macOS 15.3+ 필요), 또는 Homebrew로 설치:
    brew install --cask mattt/tap/iMCP
  • 앱이 메뉴 바에 아이콘을 배치합니다. 파란색 스위치를 켜서 MCP 서버를 시작하세요.
  • 필요한 서비스를 활성화하세요. 각 서비스는 적절한 macOS 권한을 요청합니다.
  • (선택 사항) 홈 자동화를 원하면 HomeKit 헬퍼를 빌드하세요:
    git clone https://github.com/mattt/iMCP.git
cd iMCP
Scripts/install-helper.sh   # 헬퍼를 서명하고 설치합니다

AI 클라이언트 연결

  • Claude Desktop – 설정 → 개발자 → 구성 편집을 열고, iMCP의 Claude Desktop 구성 메뉴 항목을 사용하세요. 그러면 claude_desktop_config.json에 서버 항목이 작성됩니다. Claude를 다시 시작하면 도구 목록에 망치 아이콘(🔨)과 함께 12개의 iMCP 도구가 표시됩니다.
  • Claude Code, Cursor, Amp – 각각 iMCP 서버를 전역으로 등록하는 CLI 명령(claude mcp add …, cursor …, amp mcp add …)을 제공합니다. Cursor에는 딥링크 URL도 제공됩니다.

디버깅 및 검사

  • 로컬 네트워크 권한 – imcp-server는 로컬 네트워크 개인 정보 보호 권한이 필요합니다. 시스템 설정 > 개인 정보 보호 및 보안에서 활성화하세요.
  • MCP Inspector – npx @modelcontextprotocol/inspector <server-command>를 실행하여 클라이언트와 iMCP 간의 모든 요청/응답을 보여주는 웹 UI를 엽니다.
  • Companion – 서버의 프롬프트, 리소스 및 도구를 대화형으로 탐색하기 위한 macOS 15+ 유틸리티.

대상 사용자

  • AI 강화 macOS 경험을 구축하는 개발자로서, 개인 데이터를 LLM에 노출하는 안전하고 프라이버시 우선 방식을 필요로 하는 경우.
  • AI 어시스턴트(Claude, Cursor 등)가 데이터를 수동으로 복사하지 않고도 "지금 내 위치의 날씨는?" 또는 "다음 주 화요일 오후 3시에 Alice와 회의를 잡아줘" 같은 질문에 답할 수 있기를 원하는 파워 유저.
  • Model Context Protocol에 관심이 있는 모든 사람; iMCP는 참조 구현 역할도 하며 공식 Swift SDK for MCP를 제공합니다.

작동 방식

  1. MCP 서버 – 앱은 표준 I/O를 통해 MCP를 사용하는 명령줄 실행 파일인 imcp-server를 번들로 포함합니다.
  2. 검색 – 앱과 서버는 Bonjour를 통해 _mcp._tcp 서비스를 광고하므로, 같은 Mac에 있는 모든 MCP 클라이언트가 자동으로 찾을 수 있습니다.
  3. 권한 처리 – 서비스를 활성화하면 macOS가 일반적인 권한 대화상자(예: 캘린더 전체 접근)를 표시합니다. 앱은 부여된 샌드박스 접근 권한(메시지, 통화 기록, 음성 메일 등에 대한 폴더 선택)을 저장하고 이를 사용하여 기본 SQLite 데이터베이스를 읽습니다.
  4. 데이터 형식 – 도구 결과는 Schema.org 어휘를 사용하는 JSON-LD로 반환됩니다(예: 연락처는 Person 객체가 됨). 이렇게 하면 LLM 및 기타 소프트웨어가 출력을 쉽게 사용할 수 있습니다.
  5. HomeKit 지원 – HomeKit은 Mac Catalyst 앱에서만 사용할 수 있으므로, iMCP는 별도의 iMCP Helper를 제공하며, 이 헬퍼는 사용자가 직접 Apple 개발자 계정으로 빌드하고 서명해야 합니다. 기본 앱은 로컬 TCP 포트를 통해 헬퍼와 통신합니다.

설치

  • https://iMCP.app/download 에서 서명된 앱 다운로드(macOS 15.3+ 필요), 또는 Homebrew로 설치:
    brew install --cask mattt/tap/iMCP
  • 앱이 메뉴 바에 아이콘을 배치합니다. 파란색 스위치를 켜서 MCP 서버를 시작하세요.
  • 필요한 서비스를 활성화하면 각각 적절한 macOS 권한을 요청합니다.
  • (선택 사항) 홈 자동화를 원하면 HomeKit 헬퍼를 빌드하세요:
    git clone https://github.com/mattt/iMCP.git
cd iMCP
Scripts/install-helper.sh   # 헬퍼를 서명하고 설치합니다

AI 클라이언트 연결

  • Claude Desktop – 설정 → 개발자 → 구성 편집을 열고, iMCP의 Configure Claude Desktop 메뉴 항목을 사용하세요. 이렇게 하면 claude_desktop_config.json에 서버 항목이 기록됩니다. Claude를 재시작하면 도구 목록에 12개의 iMCP 도구와 함께 망치 아이콘(🔨)이 표시됩니다.
  • Claude Code, Cursor, Amp – 각각 iMCP 서버를 전역으로 등록하는 CLI 명령(claude mcp add …, cursor …, amp mcp add …)을 제공합니다. Cursor에는 딥링크 URL도 제공됩니다.

디버깅 및 검사

  • 로컬 네트워크 권한 – imcp-server는 로컬 네트워크 개인 정보 보호 권한이 필요합니다. 시스템 설정 > 개인 정보 보호 및 보안에서 활성화하세요.
  • MCP Inspector – npx @modelcontextprotocol/inspector <server-command>를 실행하여 클라이언트와 iMCP 간의 모든 요청/응답을 보여주는 웹 UI를 엽니다.
  • Companion – 서버의 프롬프트, 리소스 및 도구를 대화형으로 탐색하기 위한 macOS 15+ 유틸리티.

대상 사용자

  • AI 강화 macOS 경험을 구축하는 개발자로서, 개인 데이터를 LLM에 노출하는 안전하고 프라이버시 우선 방식을 필요로 하는 경우.
  • AI 어시스턴트(Claude, Cursor 등)가 데이터를 수동으로 복사하지 않고도 "지금 내 위치의 날씨는?" 또는 "다음 주 화요일 오후 3시에 Alice와 회의를 예약해 줘" 같은 질문에 답변하길 원하는 파워 유저.
  • Model Context Protocol에 관심이 있는 모든 사람; iMCP는 참조 구현 역할도 하며 공식 Swift SDK for MCP를 제공합니다.

왜 중요한가

  • 개인 데이터를 기기에 유지합니다. iMCP는 자체적으로 데이터를 저장하거나 전송하지 않습니다. AI 클라이언트가 무엇을 보낼지 결정합니다.
  • 많은 LLM이 사용할 수 있는 통일되고 타입이 지정된 인터페이스(JSON-LD)를 제공하여 맞춤 스크래핑이나 수동 내보내기 스크립트의 필요성을 줄입니다.
  • macOS 시스템 서비스를 현대 AI 도구 호출 워크플로에 안전하게 연결할 수 있는 방법을 보여줍니다.

SUMMARY: iMCP는 macOS 앱으로, 캘린더, 연락처, 메시지, HomeKit 기기 및 기타 개인 데이터를 Claude Desktop과 같은 AI 클라이언트가 사용할 수 있는 MCP 호환 도구로 노출하여, 대규모 언어 모델이 해당 정보를 안전하고 로컬에서 검색하거나 조치를 취할 수 있게 합니다.

TITLE: iMCP – Model Context Protocol을 통해 AI 어시스턴트가 개인 데이터를 읽고 조치를 취할 수 있게 하는 macOS 브리지

관련

  • 프로젝트
    mediar-ai/mcp-server-macos-use

    접근성 API를 활용하여 UI를 탐색하고 사용자 입력을 시뮬레이션함으로써 AI 모델이 macOS 애플리케이션을 제어할 수 있게 해주는 MCP 서버입니다.

  • 프로젝트
    joshuayoes/ios-simulator-mcp

    AI 어시스턴트가 iOS 시뮬레이터를 제어하고 상호 작용할 수 있게 하여 자동화된 UI 테스트, 앱 탐색 및 화면 검사를 가능하게 하는 MCP 서버입니다.

  • 프로젝트
    carterlasalle/mac_messages_mcp

    AI 에이전트가 Mac에서 macOS 메시지를 읽고, 검색하고, 보내고, 연락처를 관리할 수 있게 해주는 MCP 서버.

  • 프로젝트
    mobile-next/mobile-mcp

    Mobile MCP는 AI 에이전트(Claude, Gemini 등)가 통합된 도구 세트(탭, 타이핑, 스와이프, 앱 관리, 접근성 트리를 통한 화면 검사)를 통해 iOS/Android 시뮬레이터, 에뮬레이터 및 실제 기기를 제어할 수 있게 해주는 MCP 서버입니다.

  • 프로젝트
    TKasperczyk/thunderbird-mcp

    Thunderbird MCP는 Thunderbird 애드온과 Node.js 브리지를 결합하여 Model-Context-Protocol을 통해 약 40개의 메일 관련 도구(검색, 읽기, 작성, 필터, 연락처, 캘린더)를 노출하며, 로컬 AI 어시스턴트가 메일함을 안전하게 온디바이스로 유지하면서 작업할 수 있게 합니다.