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

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

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

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

• Питон 3.6+

Related MCP server: imessage-mcp

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

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

# Using pip
pip install -r requirements.txt

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

• fastmcp : Фреймворк для построения серверов Model Context Protocol

• imessagedb : библиотека Python для доступа и запросов к базе данных сообщений macOS

• phonenumbers : библиотека обработки телефонных номеров Google для правильной проверки и форматирования номеров

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

📑 Содержание

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

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

• Инструменты МКП

• Начиная

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

  • Клод Десктоп

  • Плагин Cline VSCode

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

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

• Переменные среды

🛠️ Инструменты 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 :

1. В VSCode щелкните значок сервера (☰) на боковой панели плагина Cline.

2. Нажмите кнопку «Изменить настройки MCP» (✎)

3. Добавьте следующую конфигурацию в файл настроек:

{
  "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) для оказания помощи в разработке.

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

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