Skip to main content
Glama
Sign In
deenesjakoruzh

mac-messages-mcp

by carterlasalle
GitHub
Python
MIT License
76
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Allows reading and sending messages through the macOS Messages app, with capabilities to filter messages by contact and interact with iMessage conversations.

  • Provides access to the macOS Messages database, enabling interaction with the native messaging system on Mac computers.

Сообщения 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 .

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

Установка

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

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

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

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

Интеграция

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

  1. Перейдите в Claude > Настройки > Разработчик > Изменить конфигурацию > claude_desktop_config.json
  2. Добавьте следующую конфигурацию:
{ "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]

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

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

Лицензия

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

Внося вклад

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

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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

  1. Функции
    1. Предпосылки
      1. Установка УФ
    2. Установка
      1. Разрешение на полный доступ к диску
    3. Интеграция
      1. Интеграция рабочего стола Клода
      2. Интеграция курсора
      3. Вариант 1: Установка из PyPI
      4. Вариант 2: Установка из исходного кода
    4. Использование
      1. Как модуль
      2. Как инструмент командной строки
    5. Разработка
      1. Версионирование
    6. Заметки о безопасности
      1. Лицензия
        1. Внося вклад
          1. История Звезды

            Related Resources

            Related MCP Servers

            • apple-notifier-mcp

              turlockmike
              A
              security
              A
              license
              A
              quality
              A simple MCP server that can send notifications on mac devices.
              Last updated -
              5
              9
              8
              TypeScript
              MIT License
              • Apple

            • MCP Server Python Template

              Cris-0k
              -
              security
              A
              license
              -
              quality
              A streamlined foundation for building Model Context Protocol servers in Python, designed to make AI-assisted development of MCP tools easier and more efficient.
              Last updated -
              12
              Python
              MIT License

            • Python Apple MCP

              jxnl
              -
              security
              F
              license
              -
              quality
              A Python server that enables interaction with macOS native applications (Contacts, Notes, Mail, Messages, Reminders, Calendar, and Maps) through AppleScript, featuring asynchronous operations and type-safe interfaces.
              Last updated -
              5
              Python
              • Apple

            • iMCP

              loopwork-ai
              -
              security
              A
              license
              -
              quality
              A macOS app that provides an MCP server to your Messages, Contacts, and more
              Last updated -
              468
              Apache 2.0
              • Apple

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            ID: gxvaoc9znc