Запрос iMessage MCP-сервера

Name: imessage-query-fastmcp-mcp-server
Author: hannesrudolph

Сервер MCP, который обеспечивает безопасный доступ к вашей базе данных iMessage через Model Context Protocol (MCP). Этот сервер создан с использованием фреймворка FastMCP и библиотеки imessagedb, что позволяет LLM запрашивать и анализировать разговоры iMessage с правильной проверкой телефонного номера и обработкой вложений.

📋 Системные требования

macOS (требуется для доступа к базе данных iMessage)
Питон 3.6+

Related MCP server: MySQL MCP Server

📦 Зависимости

Установите все необходимые зависимости:

# Using pip pip install -r requirements.txt

Требуемые пакеты

fastmcp : Фреймворк для построения серверов Model Context Protocol
imessagedb : библиотека Python для доступа и запросов к базе данных сообщений macOS
phonenumbers : библиотека обработки телефонных номеров Google для правильной проверки и форматирования номеров

Все зависимости указаны в requirements.txt для легкой установки.

📑 Содержание

🛠️ Инструменты MCP

Сервер предоставляет следующие инструменты для LLM:

получить_транскрипт_чата

Извлечение истории сообщений для определенного номера телефона с возможностью фильтрации по дате. Включает:

Текст сообщения и временные метки
Информация о вложении (если есть)
Правильная проверка номера телефона
Фильтрация диапазона дат

🚀 Начало работы

Клонируйте репозиторий:

git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git cd imessage-query-fastmcp-mcp-server

📦 Варианты установки

Вы можете установить этот сервер MCP либо в Claude Desktop, либо в плагин Cline VSCode. Выберите вариант, который лучше всего соответствует вашим потребностям.

Вариант 1: Установка для Claude Desktop

Установка с помощью FastMCP:

fastmcp install imessage-query-server.py --name "iMessage Query"

Вариант 2: Установка плагина Cline VSCode

Чтобы использовать этот сервер с плагином Cline VSCode :

В VSCode щелкните значок сервера (☰) на боковой панели плагина Cline.
Нажмите кнопку «Изменить настройки MCP» (✎)
Добавьте следующую конфигурацию в файл настроек:

{ "imessage-query": { "command": "uv", "args": [ "run", "--with", "fastmcp", "fastmcp", "run", "/path/to/repo/imessage-query-server.py" ] } }

Замените /path/to/repo на полный путь к месту, куда вы клонировали этот репозиторий (например, /Users/username/Projects/imessage-query-fastmcp-mcp-server )

🔒 Функции безопасности

Доступ только для чтения к базе данных iMessage
Проверка номера телефона с использованием библиотеки телефонных номеров
Безопасная обработка вложений с обнаружением отсутствующих файлов
Проверка диапазона дат
Подавление вывода прогресса для чистых ответов JSON

📚 Документация по разработке

Репозиторий включает файлы документации для разработки:

dev_docs/imessagedb-documentation.txt : Содержит полную документацию о структуре базы данных iMessage и возможностях библиотеки imessagedb.

Эта документация служит контекстом при разработке функций и может использоваться совместно со студентами магистратуры (LLM) для оказания помощи в разработке.