mac-сообщения-mcp

Сообщения Mac MCP

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

$схема-компьютера-Mac-с-tex\_FvvnmbaBTFeKy6F2GMlLqA\_IfCBMgJARcia1WTH7FaqwA$

Функции

Прочитайте последние сообщения из приложения «Сообщения» 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]

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

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

Лицензия

Массачусетский технологический институт

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

История Звезды

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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

Reddit Discussion about this server

Related MCP Servers

Apple MCP Server
supermemoryai
A
security
A
license
A
quality
Enables 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 -
6
119
2,248
TypeScript
MIT License
iMCP
mattt
-
security
A
license
-
quality
A macOS app that provides an MCP server to your Messages, Contacts, and more
Last updated -
742
MIT License
Apple MCP
zackbissell
-
security
A
license
-
quality
A 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.
Last updated -
119
TypeScript
MIT License
KaitoMCPServer
yang-han
-
security
F
license
-
quality
A Python-based MCP server that uses uv for dependency management, requiring Python 3.13+ to run.
Last updated -
Python

View all related MCP servers

mac-messages-mcp