iMessage-Abfrage-MCP-Server

Name: imessage-query-fastmcp-mcp-server
Author: hannesrudolph

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: MySQL MCP Server

📦 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

🛠️ 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 :

Klicken Sie in VSCode auf das Serversymbol (☰) in der Seitenleiste des Cline-Plugins.
Klicken Sie auf die Schaltfläche „MCP-Einstellungen bearbeiten“ (✎).
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.