imessage-query-fastmcp-mcp-server

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

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

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

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

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

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

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

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

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

📑 Содержание

• Системные требования
• Зависимости
• Инструменты МКП
• Начиная
• Варианты установки
  • Клод Десктоп
  • Плагин Cline VSCode
• Функции безопасности
• Документация по разработке
• Переменные среды

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

⚙️ Переменные среды

Переменные среды не требуются, поскольку сервер автоматически находит базу данных iMessage в расположении macOS по умолчанию.