iMessage Query MCP Server
предоставляет безопасный доступ к базе iMessage для LLM через MCP с анализом чатов, валидацией номеров и обработкой вложений
Описание
Это MCP-сервер на базе FastMCP и imessagedb для macOS, позволяющий LLM запрашивать историю iMessage-чаты по номеру телефона с фильтрами по датам. Включает валидацию номеров (phonenumbers), обработку вложений, автоматическую настройку разрешений Full Disk Access. Технологии: Python 3.12+, uv для зависимостей. Применения: анализ разговоров, извлечение метаданных для ИИ, безопасное чтение БД без модификаций. Только чтение, с фокусом на приватность.
Возможности
Получение транскрипта чата
Извлечение истории сообщений по номеру телефона с фильтрами по датам (start_date, end_date), включая текст, timestamps и флаг отправителя.
Валидация номеров
Автоматическая проверка и форматирование номеров в E.164 с использованием библиотеки phonenumbers, поддержка различных форматов.
Обработка вложений
Обнаружение и извлечение метаданных вложений, выявление отсутствующих файлов без изменения БД.
Настройка разрешений
Автоматическое обнаружение клиента (Claude, VS Code) и открытие настроек macOS для Full Disk Access, только чтение БД.
Фильтрация по датам
Ограничение запросов периодом (по умолчанию последние 7 дней), валидация дат для предотвращения ошибок.
Установка
{ “mcpServers”: { “imessage-query”: { “command”: “/full/path/to/imessage-query-server.py” } } }
Клонируйте репозиторий: git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git cd imessage-query-fastmcp-mcp-server
Установите uv: brew install uv
Добавьте конфиг в файл клиента (например, ~/Library/Application Support/Claude/claude_desktop_config.json для Claude Desktop), укажите полный путь к imessage-query-server.py. Перезапустите клиент. Требует Full Disk Access для клиента в macOS Privacy & Security.