iMCP

iMCP는 디지털 라이프를 AI와 연결하는 macOS 앱입니다. Claude Desktop 및 Model Context Protocol(MCP)을 지원하는 다양한 클라이언트 와 호환됩니다.

역량

[!TIP] 새로운 기능에 대한 제안이 있으신가요? imcp@loopwork.com 으로 문의해 주세요.

시작하기

앱을 다운로드하고 열어보세요

먼저 iMCP 앱을 다운로드하세요 (macOS 15.3 이상 필요).

앱을 열면 메뉴 막대에 아이콘이 표시됩니다.

이 아이콘을 클릭하면 사용 가능한 모든 서비스를 표시하는 iMCP 메뉴가 나타납니다. 처음에는 모든 서비스가 회색으로 표시되어 비활성 상태임을 나타냅니다.

위쪽의 파란색 토글 스위치는 MCP 서버가 실행 중이고 MCP 호환 클라이언트에 연결할 준비가 되었음을 나타냅니다.

서비스 활성화

서비스를 활성화하려면 해당 아이콘을 클릭하세요. 시스템에서 권한 설정 대화 상자가 표시됩니다. 예를 들어 캘린더 접근 권한을 활성화하면 "iMCP" Would Like Full Access to Your Calendar 라는 대화 상자가 나타납니다. "전체 접근 허용"을 클릭하여 계속 진행하세요.

[!중요] iMCP는 사용자의 데이터를 수집하거나 저장 하지 않습니다 . Claude Desktop과 같은 클라이언트는 도구 호출의 일환으로 사용자의 데이터를 기기 외부로 전송 합니다 .

각 서비스 아이콘이 활성화되면 회색에서 고유한 색상으로 바뀝니다. 달력은 빨간색, 메시지는 녹색, 위치는 파란색 등으로 표시됩니다.

활성화하려는 모든 기능에 대해 이 과정을 반복하세요. 이러한 권한은 Apple의 표준 보안 모델을 따르므로 iMCP가 접근할 수 있는 정보를 완벽하게 제어할 수 있습니다.

Claude Desktop에 연결

Claude Desktop이 설치되어 있지 않으면 여기에서 다운로드 할 수 있습니다.

Claude Desktop을 열고 "설정..."(⌘,)으로 이동합니다. 설정 창의 사이드바에서 "개발자"를 클릭한 다음 "구성 편집"을 클릭합니다. 그러면 ~/Library/Application Support/Claude/claude_desktop_config.json 에 구성 파일이 생성됩니다.

iMCP를 Claude Desktop에 연결하려면 > "Claude Desktop 구성"을 클릭하세요.

이렇게 하면 애플리케이션에 포함된 imcp-server 실행 파일을 사용하도록 MCP 서버 구성이 추가되거나 업데이트됩니다. 파일의 다른 MCP 서버 구성은 그대로 유지됩니다.

"서버 명령을 클립보드에 복사"를 클릭하세요. 그런 다음 편집기에서 claude_desktop_config.json 을 열고 다음을 입력하세요.

지엑스피1

Claude Desktop에서 iMCP 도구 호출

Claude Desktop 앱을 종료했다가 다시 여세요. 연결을 승인하라는 메시지가 표시됩니다.

[!참고] 이 대화 상자가 두 번 나타날 수 있습니다. 두 번 모두 승인을 클릭하세요.

연결을 승인하면 채팅 상자 오른쪽 하단에 🔨12가 표시됩니다. 이 아이콘을 클릭하면 iMCP에서 Claude에게 제공하는 모든 도구 목록을 볼 수 있습니다.

이제 귀하의 개인 데이터에 접근해야 하는 다음과 같은 질문을 클로드에게 할 수 있습니다.

"제가 있는 곳의 날씨는 어때요?"

클로드는 적절한 도구를 사용하여 이 정보를 검색하여 대화 중에 수동으로 데이터를 공유하지 않고도 정확하고 개인화된 응답을 제공합니다.

기술적 세부 사항

앱 및 CLI

iMCP는 명령줄 실행 파일인 imcp-server 묶은 macOS 앱입니다.

• iMCP.app 서비스 구성을 위한 UI를 제공하고, 가장 중요한 점은 macOS 시스템 권한과 상호 작용할 수 있는 수단을 제공하여 연락처, 캘린더 및 기타 정보에 액세스할 수 있도록 합니다.
• imcp-server 통신을 위해 표준 입출력( stdio 전송 )을 사용하는 MCP 서버를 제공합니다.

앱과 CLI는 로컬 네트워크에서 Bonjour를 사용하여 자동 검색을 통해 서로 통신합니다. 두 서비스 모두 유형이 "_mcp._tcp"이고 도메인이 "local"인 서비스를 광고합니다. MCP 클라이언트의 요청은 CLI가 stdin 에서 읽어 앱으로 전달하고, 앱의 응답은 CLI가 수신하여 stdout 에 기록합니다. 구현 세부 정보는 StdioProxy 참조하세요.

이 프로젝트를 위해 모델 컨텍스트 프로토콜 서버와 클라이언트를 위한 Swift SDK인 mcp-swift-sdk를 개발했습니다. 앱은 이 패키지를 사용하여 MCP 클라이언트의 프록시 요청을 처리합니다.

iMessage 데이터베이스 액세스

Apple은 메시지에 접근하기 위한 공개 API를 제공하지 않습니다. 하지만 macOS의 메시지 앱은 ~/Library/Messages/chat.db 에 있는 SQLite 데이터베이스에 데이터를 저장합니다.

iMCP는 앱 샌드박스 에서 실행되므로 사용자 데이터 및 시스템 리소스에 대한 접근이 제한됩니다. 메시지 서비스를 활성화하면 표준 파일 선택기를 통해 chat.db 파일을 열라는 메시지가 표시됩니다. 그러면 macOS가 해당 파일을 앱의 샌드박스에 추가합니다. NSOpenPanel 이처럼 마법과 같습니다.

하지만 iMessage 데이터베이스를 공개하는 것은 시작에 불과합니다. 지난 몇 년 동안 Apple은 메시지를 일반 텍스트로 저장하는 방식에서 벗어나 자체적인 typedstream 형식으로 저장 방식을 전환해 왔습니다.

이 프로젝트를 위해 iMessage 데이터베이스를 읽기 위한 Swift 패키지인 Madrid를 개발했습니다. 이 패키지에는 Christopher Sardegna의 imessage-exporter 프로젝트와 typedstream 리버스 엔지니어링에 대한 블로그 게시물을 바탕으로 Apple의 typedstream 형식을 디코딩하는 Swift 구현이 포함되어 있습니다.

도구 결과에 대한 JSON-LD

iMCP에서 제공하는 도구는 결과를 JSON-LD 문서로 반환합니다. 예를 들어, fetchContacts 도구는 CNContact 유형으로 사람과 조직을 표현하는 Contacts 프레임워크를 사용합니다. 해당 유형의 객체를 JSON-LD로 인코딩하는 방법은 다음과 같습니다.

Schema.org는 사람, 우편 주소, 이벤트 등 우리가 표현하고자 하는 여러 객체에 대한 표준 어휘를 제공합니다. 또한 JSON-LD는 사람, AI, 그리고 기존 소프트웨어 모두에게 편리한 인코딩 형식입니다.

이 프로젝트를 위해 구조화된 데이터 작업을 위한 Swift 패키지인 Ontology를 개발했습니다. Ontology에는 iMCP 도구에서 반환되는 것과 같은 Apple 프레임워크의 유형에 대한 편의 초기화 프로그램이 포함되어 있습니다.

감사의 말

• Justin Spahr-Summers ( @jspahrsummers ), David Soria Parra( @dsp-ant ), Ashwin Bhat( @ashwin-ant )는 MCP 작업에 참여했습니다.
• Christopher Sardegna ( @ReagentX )는 메시지 앱에서 사용하는 typedstream 형식을 리버스 엔지니어링한 공로를 인정받았습니다.

특허

이 프로젝트는 Apache 라이선스 버전 2.0에 따라 라이선스가 부여되었습니다.

합법적인

iMessage®는 Apple Inc.의 등록 상표입니다.
이 프로젝트는 Apple Inc.와 제휴, 보증 또는 후원을 받지 않습니다.