Сообщения Mac MCP

Мост Python для взаимодействия с приложением macOS Messages с использованием MCP (Multiple Context Protocol).

Загрузки PyPI

схема-компьютера-Mac-с-tex_FvvnmbaBTFeKy6F2GMlLqA_IfCBMgJARcia1WTH7FaqwA

Функции

Прочитайте последние сообщения из приложения «Сообщения» macOS
Фильтровать сообщения по контакту
Отправляйте новые сообщения через iMessage
Доступ к сообщениям через API

Related MCP server: MCP Python Server

Предпосылки

macOS (протестировано на macOS 11+)
Питон 3.10+
менеджер пакетов uv

Установка УФ

Если вы используете Mac, установите uv с помощью Homebrew:

brew install uv

В противном случае следуйте инструкциям по установке на сайте uv .

⚠️ Не продолжайте работу до установки УФ-излучения.

Установка

Разрешение на полный доступ к диску

⚠️ Для доступа к базе данных сообщений этому приложению требуются права полного доступа к диску для вашего терминала или приложения.

Чтобы предоставить полный доступ к диску:

Откройте Системные настройки/Настройки > Безопасность и конфиденциальность/Конфиденциальность > Полный доступ к диску.
Нажмите на значок замка, чтобы внести изменения.
Добавьте в список свое терминальное приложение (Terminal, iTerm2 и т. д.) или Claude Desktop/Cursor
Перезапустите терминал или приложение после предоставления разрешения.

Интеграция

Интеграция рабочего стола Клода

Перейдите в Claude > Настройки > Разработчик > Изменить конфигурацию > claude_desktop_config.json
Добавьте следующую конфигурацию:

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

Интеграция курсора

Перейдите в Настройки курсора > MCP и вставьте это как команду:

uvx mac-messages-mcp

⚠️ Запускайте только один экземпляр сервера MCP (либо на Cursor, либо на Claude Desktop), а не оба

Вариант 1: Установка из PyPI

uv pip install mac-messages-mcp

Вариант 2: Установка из исходного кода

# Clone the repository
git clone https://github.com/carterlasalle/mac_messages_mcp.git
cd mac_messages_mcp

# Install dependencies
uv install -e .

Использование

Как модуль

from mac_messages_mcp import get_recent_messages, send_message

# Get recent messages
messages = get_recent_messages(hours=48)
print(messages)

# Send a message
result = send_message(recipient="+1234567890", message="Hello from Mac Messages MCP!")
print(result)

Как инструмент командной строки

# Run the MCP server directly
mac-messages-mcp

Разработка

Версионирование

Этот проект использует семантическое версионирование. Подробности о том, как работает система версионирования и как выпускать новые версии, см. на сайте VERSIONING.md.

Чтобы повысить версию:

python scripts/bump_version.py [patch|minor|major]

Заметки о безопасности

Это приложение напрямую обращается к базе данных сообщений, содержащей личные сообщения. Пожалуйста, используйте его ответственно и убедитесь, что у вас есть соответствующие разрешения.