Сообщения Mac MCP

Name: mac-messages-mcp
Author: carterlasalle

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

Загрузки PyPI

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

Функции

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

Related MCP server: iMCP

Предпосылки

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]

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

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