A
securityA
licenseA
qualityEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Last updated -
7
287
2,491
MIT License
Сообщения Mac MCP
Мост Python для взаимодействия с приложением macOS Messages с использованием MCP (Multiple Context Protocol).
Функции
Прочитайте последние сообщения из приложения «Сообщения» macOS
Фильтровать сообщения по контакту
Отправляйте новые сообщения через iMessage
Доступ к сообщениям через API
Предпосылки
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]
Заметки о безопасности
Это приложение напрямую обращается к базе данных сообщений, содержащей личные сообщения. Пожалуйста, используйте его ответственно и убедитесь, что у вас есть соответствующие разрешения.
Лицензия
Массачусетский технологический институт
Внося вклад
Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.
История Звезды
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
Мост Python для взаимодействия с приложением macOS Messages с использованием MCP (Multiple Context Protocol). Простая установка с помощью uvx mac-messages-mcp
- Функции
- Предпосылки
- Установка
- Интеграция
- Использование
- Разработка
- Заметки о безопасности
- Лицензия
- Внося вклад
- История Звезды
Related Resources
Related MCP Servers
- -securityAlicense-qualityA macOS app that provides an MCP server to your Messages, Contacts, and moreLast updated -830MIT License
- -securityAlicense-qualityA collection of Apple-native tools for the MCP protocol that enables AI assistants to interact with Apple applications including Messages, Notes, Contacts, Mail, Reminders, Calendar, and Maps.
- -securityFlicense-qualityA Python-based MCP server that uses uv for dependency management, requiring Python 3.13+ to run.