iMessage 쿼리 MCP 서버
모델 컨텍스트 프로토콜(MCP)을 통해 iMessage 데이터베이스에 안전하게 액세스할 수 있도록 하는 MCP 서버입니다. 이 서버는 FastMCP 프레임워크와 imessagedb 라이브러리를 기반으로 구축되어 LLM이 전화번호 유효성 검사 및 첨부 파일 처리를 통해 iMessage 대화를 쿼리하고 분석할 수 있도록 지원합니다.
📋 시스템 요구 사항
- macOS(iMessage 데이터베이스 액세스에 필요)
- 파이썬 3.6 이상
📦 종속성
필요한 모든 종속성을 설치하세요:
지엑스피1
필수 패키지
- fastmcp : 모델 컨텍스트 프로토콜 서버를 구축하기 위한 프레임워크
- imessagedb : macOS 메시지 데이터베이스에 액세스하고 쿼리하기 위한 Python 라이브러리
- 전화번호 : 적절한 숫자 검증 및 형식 지정을 위한 Google의 전화번호 처리 라이브러리
모든 종속성은 requirements.txt
에 지정되어 있어 쉽게 설치할 수 있습니다.
📑 목차
🛠️ MCP 도구
서버는 LLM에 다음 도구를 제공합니다.
채팅 기록 받기
날짜 필터링을 선택하여 특정 전화번호의 메시지 기록을 검색합니다. 다음이 포함됩니다.
- 메시지 텍스트 및 타임스탬프
- 첨부 정보(있는 경우)
- 전화번호의 정확한 검증
- 날짜 범위 필터링
🚀 시작하기
저장소를 복제합니다.
📦 설치 옵션
이 MCP 서버는 Claude Desktop 또는 Cline VSCode 플러그인에 설치할 수 있습니다. 필요에 가장 적합한 옵션을 선택하세요.
옵션 1: Claude Desktop용 설치
FastMCP를 사용하여 설치:
옵션 2: Cline VSCode 플러그인 설치
이 서버를 Cline VSCode 플러그인 과 함께 사용하려면:
- VSCode에서 Cline 플러그인 사이드바의 서버 아이콘(☰)을 클릭합니다.
- "MCP 설정 편집" 버튼을 클릭하세요(✎)
- 설정 파일에 다음 구성을 추가합니다.
/path/to/repo
이 저장소를 복제한 전체 경로로 바꾸세요(예: /Users/username/Projects/imessage-query-fastmcp-mcp-server
)
🔒 안전 기능
- iMessage 데이터베이스에 대한 읽기 전용 액세스
- phonenumbers 라이브러리를 사용한 전화번호 검증
- 누락된 파일 감지를 통한 안전한 첨부 파일 처리
- 날짜 범위 검증
- 깨끗한 JSON 응답을 위한 진행 출력 억제
📚 개발 문서
저장소에는 개발을 위한 문서 파일이 포함되어 있습니다.
dev_docs/imessagedb-documentation.txt
: iMessage 데이터베이스 구조와 imessagedb 라이브러리 기능에 대한 포괄적인 설명서가 포함되어 있습니다.
이 문서는 기능을 개발할 때 맥락으로 활용되며 LLM과 함께 사용하여 개발을 지원할 수 있습니다.
⚙️ 환경 변수
서버가 자동으로 기본 macOS 위치에서 iMessage 데이터베이스를 찾으므로 환경 변수가 필요하지 않습니다.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
MCP를 통해 iMessage 데이터베이스에 안전하게 액세스할 수 있는 MCP 서버로, LLM이 적절한 전화번호 검증 및 첨부 파일 처리를 통해 iMessage 대화를 쿼리하고 분석할 수 있도록 합니다.
Related MCP Servers
- -securityFlicense-qualityAn MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.Last updated -116JavaScript
- -securityAlicense-qualityA server for the Machine Chat Protocol (MCP) that provides a YAML-based configuration system for LLM applications, allowing users to define resources, tools, and prompts without writing code.Last updated -5PythonMIT License
- -securityFlicense-qualityAn MCP server that allows Claude and other LLMs to manage persistent memories across conversations through text file storage, enabling commands to add, search, delete and list memory entries.Last updated -2TypeScript
- -securityAlicense-qualityA macOS app that provides an MCP server to your Messages, Contacts, and moreLast updated -646Apache 2.0