carterlasalle/mac_messages_mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

340 stars 55 forks Качество 90 Тренд 40MIT

carterlasalle/mac_messages_mcp — это кандидат для MCP-сервера, импортированный из https://github.com/carterlasalle/mac_messages_mcp.

Обзор

carterlasalle/mac_messages_mcp — это кандидат для MCP-сервера, импортированный из https://github.com/carterlasalle/mac_messages_mcp.

Обзор (машинный перевод)

Читать, искать и отправлять сообщения macOS от любого локального клиента MCP.

Быстрый старт · Доступные инструменты · Навык агента · Интерфейс командной строки · Безопасность · Журнал изменений

Используйте Claude, Codex, Cursor, VS Code или любой локальный клиент MCP для поиска, чтения и отправляйте сообщения через приложение Messages для macOS.

Mac Messages MCP работает локально на вашем Mac. Он открывает раздел «Сообщения и контакты» базы данных только для чтения, возвращают только те данные, которые запрашивает клиент, и использует Messages.app автоматизацию только тогда, когда клиент явно вызывает инструмент отправки.

[! ВАЖНО] Этот сервер работает только на macOS. Чтение сообщений требует полного диска Access. Для отправки требуется Mac, вошедший в Messages, плюс разрешение на запуск приложения для автоматизации сообщений.

Как это работает

Всё, что читает клиент, поступает из локальных баз данных SQLite, открытых только для чтения. Всё, что выходит из аппарата, выходит через Messages.app, под явным вызовом инструмента отправки. Текст, полученный от сообщений и контактов, разделяется как ненадёжные данные на пути обратно к модели.

Возможности

Область	Что предоставляет Mac Messages MCP

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Use Claude, Codex, Cursor, VS Code, or any local MCP client to search, read, and send messages through the macOS Messages app.

Mac Messages MCP runs locally on your Mac. It opens the Messages and Contacts databases read-only, returns only the data a client asks for, and uses Messages.app automation only when the client explicitly calls the send tool.

[!IMPORTANT] This server is macOS-only. Reading messages requires Full Disk Access. Sending requires a Mac signed into Messages plus permission for the launching app to automate Messages.

How it works

flowchart LR
    A[MCP client] -->|stdio| B[mac-messages-mcp]
    B --> C{Tool call}
    C -->|read tools| D[(chat.db read-only)]
    C -->|read tools| E[(AddressBook read-only)]
    C -->|send tools| F[Messages.app]
    F --> G[Recipient]
    D --> H[Untrusted-output boundary]
    E --> H
    H --> A

Everything the client reads comes from the local SQLite databases, opened read-only. Everything that leaves the machine goes out through Messages.app, under an explicit send tool call. Message- and contact-derived text is fenced as untrusted data on the way back to the model.

Capabilities

Area	What Mac Messages MCP provides
Reading	Recent messages across all conversations or filtered by contact, group chat, date range, or unread state; paging with `limit`/`offset` and forward-cursor reads
Conversations	Every conversation (1:1, business, and group) with kind, message and unread counts, last activity, and a blocking wait for new messages
Search	Fuzzy message-body search across a time window or all history, scoped to a contact or conversation
Context	Per-message service (iMessage/SMS/RCS), unread and delivery state, tapbacks, and threaded replies
Contacts	Fuzzy contact lookup by approximate name, send-ready phone numbers, and contact creation

Открыть полный README на GitHub

Установка

uvx mac-messages-mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "mac-messages": {
      "command": "uvx",
      "args": ["mac-messages-mcp"]
    }
  }
}