carterlasalle/mac_messages_mcp

Диагностирует доступ на чтение к локальной базе данных macOS AddressBook. Это операция только для чтения: она проверяет, может ли сервер найти и прочитать локальные данные Contacts/AddressBook, и возвращает текстовый диагностический отчет с ошибками прав доступа или путей. Она не изменяет контакты. Используйте этот инструмент, когда поиск контактов не удается; используйте tool_check_db_access, когда чтение базы данных Messages завершается ошибкой.

Выводит небольшую выборку контактов из AddressBook. Этот режим только для чтения: загружает кэшированные локальные имена контактов и номера телефонов и возвращает количество в виде обычного текста плюс примеры записей. Требует разрешения Contacts/AddressBook. Используйте это, чтобы подтвердить, что поиск контактов заполнен; используйте tool_find_contact, чтобы найти конкретного человека, и tool_check_addressbook, чтобы диагностировать ошибки разрешений или доступа к базе данных.

Диагностирует доступ на чтение к локальной базе данных Messages в macOS. Это read-only: проверяет, может ли сервер найти и запросить базу данных Messages SQLite, и возвращает диагностический отчёт в виде обычного текста с любыми ошибками прав доступа или путей. Требует Full Disk Access для хост-приложения или терминала. Используйте это после того, как чтение/поиск сообщений завершился ошибкой или вернул ошибки прав доступа; используйте tool_check_addressbook для проблем с доступом к Contacts/AddressBook.

Проверяет, доступен ли получатель через iMessage. Это проверка доступности только для чтения к локальным сервисам Messages; она не отправляет сообщение. Требует, чтобы Messages были настроены на этом Mac. Возвращает результат в виде обычного текста, указывающий на доступность iMessage или вероятное резервное использование SMS/RCS для номеров телефонов. Используйте этот инструмент перед tool_send_message, когда важен маршрут доставки; используйте tool_find_contact сначала, если у вас есть только имя контакта.

Находит контакты AddressBook с помощью нечеткого сопоставления имен. Это только чтение: ищет локальные контакты и не отправляет сообщения никому и не изменяет контакты. Требует разрешения Contacts/AddressBook для хост-приложения или терминала. Возвращает один результат в виде обычного текста или нумерованный список с оценками достоверности; используйте возвращаемый селектор "contact:N" с tool_send_message или tool_get_recent_messages. Используйте tool_check_contacts для просмотра доступных кэшированных контактов, а tool_fuzzy_search_messages — при поиске по тексту сообщений.

Выполняет нечеткий поиск текста сообщений в локальной базе за временной интервал. Это операция только для чтения: запрашивает локальную базу данных Messages и не отправляет, не редактирует и не удаляет сообщения. Требует разрешения Full Disk Access для хост-приложения или терминала. Возвращает список совпадающих сообщений в виде обычного текста с оценками схожести, временными метками, участниками, очищенным содержимым и отметками о вложениях, если они есть. Используйте этот инструмент для приблизительного поиска текста; используйте tool_get_recent_messages для получения нефильтрованного хронологического контекста, а tool_find_contact — для поиска контактов.

Получает конкретное вложение по его ROWID в базе данных. Это операция только для чтения: она находит локальный файл вложения из Сообщений и не изменяет и не удаляет его. Требует полного доступа к диску (Full Disk Access) для хост-приложения или терминала. Для MIME-типов изображений размером меньше max_bytes возвращает изображение встроенным (inline), чтобы вы могли видеть его напрямую. Для PDF, видео, аудио, отсутствующих файлов или изображений слишком большого размера возвращает путь в файловой системе в виде простого текста или ошибку. Сначала используйте tool_search_attachments, если у вас ещё нет идентификатора вложения.

Выводит список именованных групповых чатов из базы данных macOS Messages. Это только чтение: запрашивает идентификаторы чатов и отображаемые имена и не отправляет, не редактирует и не удаляет сообщения. Требует Full Disk Access для основного приложения или терминала. Возвращает обычный текстовый нумерованный список имен групп и ID. Используйте этот инструмент перед tool_send_message с group_chat=true; используйте tool_get_recent_messages, когда нужны содержимое сообщений, а не ID чатов.

Читает недавние сообщения macOS в виде текстовой сводки. Инструмент только для чтения: он запрашивает локальную базу данных Messages, но не отправляет, не редактирует и не удаляет сообщения. Требует полного доступа к диску macOS (Full Disk Access) для хост-приложения или терминала. Возвращает очищенный текст сообщений, временные метки, участников и компактные маркеры вложений, если файлы присутствуют. Используйте contact для личных бесед и chat_id для групповых, но не одновременно. Применяйте, когда нужен хронологический контекст недавних сообщений; для поиска по тексту используйте tool_fuzzy_search_messages, а если нужны только ID групповых чатов — tool_get_chats.

Ищет вложения сообщений по диапазону дат, контакту и MIME-типу. Операция только для чтения, возвращает только метаданные; не возвращает содержимое файлов и не изменяет вложения. Требует полного доступа к диску для хост-приложения или терминала. Результаты включают идентификаторы вложений, MIME-типы, имена файлов, размеры, временные метки и отправителей. Используйте эту операцию для дешёвого поиска подходящих файлов, затем вызовите tool_get_attachment для одного конкретного вложения. Используйте tool_fuzzy_search_messages при поиске текста сообщений вместо метаданных вложений.

Отправляет одно исходящее сообщение через приложение macOS Messages. Это действие имеет внешний побочный эффект: отправляет указанный текст получателю с помощью Messages. Может использовать iMessage или SMS/RCS в зависимости от доступности получателя и настроек Messages. Требует разрешения Automation для Messages, а сам Mac должен быть способен отправлять сообщения этому получателю. Возвращает обычный текст с сообщением об успехе или ошибке; не удаляет и не изменяет существующие переписки. Сначала используйте tool_find_contact, если имя неоднозначно, и tool_check_imessage_availability, когда надежность доставки под вопросом.