imessage-query-fastmcp-mcp-server

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+

📦 Abhängigkeiten

Installieren Sie alle erforderlichen Abhängigkeiten:

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:

📦 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:

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:

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.