Mac-Nachrichten MCP

Name: mac-messages-mcp
Author: carterlasalle

Eine Python-Brücke für die Interaktion mit der macOS-Nachrichten-App unter Verwendung von MCP (Multiple Context Protocol).

PyPI-Downloads

ein Diagramm eines Mac-Computers mit dem Tex_FvvnmbaBTFeKy6F2GMlLqA_IfCBMgJARcia1WTH7FaqwA

Merkmale

Lesen Sie aktuelle Nachrichten aus der macOS-Nachrichten-App
Nachrichten nach Kontakt filtern
Senden Sie neue Nachrichten über iMessage
Zugriff auf Nachrichten über eine API

Related MCP server: iMCP

Voraussetzungen

macOS (getestet auf macOS 11+)
Python 3.10+
UV-Paketmanager

UV installieren

Wenn Sie einen Mac verwenden, installieren Sie uv mit Homebrew:

brew install uv

Andernfalls folgen Sie den Installationsanweisungen auf der UV-Website .

⚠️ Fahren Sie nicht fort, bevor Sie uv installiert haben

Installation

Volle Festplattenzugriffsberechtigung

⚠️ Diese Anwendung erfordert die Berechtigung „Voller Festplattenzugriff“ für Ihr Terminal oder Ihre Anwendung, um auf die Nachrichtendatenbank zuzugreifen.

So gewähren Sie vollständigen Festplattenzugriff:

Öffnen Sie Systemeinstellungen/Einstellungen > Sicherheit und Datenschutz/Datenschutz > Vollständiger Festplattenzugriff
Klicken Sie auf das Schlosssymbol, um Änderungen vorzunehmen
Fügen Sie Ihre Terminal-App (Terminal, iTerm2 usw.) oder Claude Desktop/Cursor zur Liste hinzu
Starten Sie Ihr Terminal oder Ihre Anwendung neu, nachdem Sie die Berechtigung erteilt haben

Integration

Claude Desktop Integration

Gehen Sie zu Claude > Einstellungen > Entwickler > Konfiguration bearbeiten > claude_desktop_config.json
Fügen Sie die folgende Konfiguration hinzu:

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

Cursor-Integration

Gehen Sie zu Cursoreinstellungen > MCP und fügen Sie dies als Befehl ein:

uvx mac-messages-mcp

⚠️ Führen Sie nur eine Instanz des MCP-Servers aus (entweder auf Cursor oder Claude Desktop), nicht beide

Option 1: Von PyPI installieren

uv pip install mac-messages-mcp

Option 2: Von der Quelle installieren

# Clone the repository git clone https://github.com/carterlasalle/mac_messages_mcp.git cd mac_messages_mcp # Install dependencies uv install -e .

Verwendung

Als Modul

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)

Als Befehlszeilentool

# Run the MCP server directly mac-messages-mcp

Entwicklung

Versionierung

Dieses Projekt verwendet semantische Versionierung. Weitere Informationen zur Funktionsweise des Versionssystems und zur Veröffentlichung neuer Versionen finden Sie in VERSIONING.md .

So erhöhen Sie die Version:

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

Sicherheitshinweise

Diese Anwendung greift direkt auf die Nachrichtendatenbank zu, die persönliche Nachrichten enthält. Bitte verwenden Sie sie verantwortungsvoll und stellen Sie sicher, dass Sie über die entsprechenden Berechtigungen verfügen.