Mac-Nachrichten-MCP

Mac-Nachrichten MCP

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

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

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.

mac-messages-mcp

Integrations