iMessage-Abfrage-MCP-Server

Ein MCP-Server, der sicheren Zugriff auf Ihre iMessage-Datenbank über das Model Context Protocol (MCP) bietet. Dieser Server basiert auf dem FastMCP-Framework und der imessagedb-Bibliothek und ermöglicht LLMs die Abfrage und Analyse von iMessage-Konversationen mit korrekter Telefonnummernvalidierung und Anhangsverarbeitung.

📋 Systemanforderungen

• macOS (erforderlich für den Zugriff auf die iMessage-Datenbank)

• Python 3.6+

Related MCP server: imessage-mcp

📦 Abhängigkeiten

Installieren Sie alle erforderlichen Abhängigkeiten:

# Using pip
pip install -r requirements.txt

Erforderliche Pakete

• fastmcp : Framework zum Erstellen von Model Context Protocol-Servern

• imessagedb : Python-Bibliothek für den Zugriff auf und die Abfrage der macOS-Nachrichtendatenbank

• Telefonnummern : Googles Bibliothek zur Handhabung von Telefonnummern für die korrekte Validierung und Formatierung von Nummern

Zur einfachen Installation sind alle Abhängigkeiten in requirements.txt angegeben.

📑 Inhaltsverzeichnis

• Systemanforderungen

• Abhängigkeiten

• MCP-Tools

• Erste Schritte

• Installationsoptionen

  • Claude Desktop

  • Cline VSCode-Plugin

• Sicherheitsfunktionen

• Entwicklungsdokumentation

• Umgebungsvariablen

🛠️ MCP-Tools

Der Server stellt LLMs die folgenden Tools zur Verfügung:

get_chat_transcript

Rufen Sie den Nachrichtenverlauf für eine bestimmte Telefonnummer mit optionaler Datumsfilterung ab. Enthält:

• Nachrichtentext und Zeitstempel

• Anhangsinformationen (falls vorhanden)

• Richtige Validierung der Telefonnummer

• Datumsbereichsfilterung

🚀 Erste Schritte

Klonen Sie das Repository:

git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git
cd imessage-query-fastmcp-mcp-server

📦 Installationsoptionen

Sie können diesen MCP-Server entweder in Claude Desktop oder im Cline VSCode-Plugin installieren. Wählen Sie die Option, die Ihren Anforderungen am besten entspricht.

Option 1: Für Claude Desktop installieren

Installation mit FastMCP:

fastmcp install imessage-query-server.py --name "iMessage Query"

Option 2: Installation für das Cline VSCode-Plugin

So verwenden Sie diesen Server mit dem Cline VSCode-Plugin :

1. Klicken Sie in VSCode auf das Serversymbol (☰) in der Seitenleiste des Cline-Plugins.

2. Klicken Sie auf die Schaltfläche „MCP-Einstellungen bearbeiten“ (✎).

3. Fügen Sie der Einstellungsdatei die folgende Konfiguration hinzu:

{
  "imessage-query": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "fastmcp",
      "fastmcp",
      "run",
      "/path/to/repo/imessage-query-server.py"
    ]
  }
}

Ersetzen Sie /path/to/repo durch den vollständigen Pfad zum Klonort dieses Repositorys (z. B. /Users/username/Projects/imessage-query-fastmcp-mcp-server ).

🔒 Sicherheitsfunktionen

• Nur-Lese-Zugriff auf die iMessage-Datenbank

• Telefonnummernvalidierung mithilfe der Telefonnummernbibliothek

• Sichere Handhabung von Anhängen mit Erkennung fehlender Dateien

• Datumsbereichsvalidierung

• Unterdrückung der Fortschrittsausgabe für saubere JSON-Antworten

📚 Entwicklungsdokumentation

Das Repository enthält Dokumentationsdateien für die Entwicklung:

• dev_docs/imessagedb-documentation.txt : Enthält eine umfassende Dokumentation zur iMessage-Datenbankstruktur und den Funktionen der imessagedb-Bibliothek.

Diese Dokumentation dient als Kontext bei der Entwicklung von Funktionen und kann mit LLMs zur Unterstützung der Entwicklung verwendet werden.

⚙️ Umgebungsvariablen

Es sind keine Umgebungsvariablen erforderlich, da der Server die iMessage-Datenbank automatisch am Standardspeicherort von macOS lokalisiert.