Skip to main content
Glama
imessage-query-fastmcp-mcp-server

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+

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

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A local MCP server that enables reading iMessage conversations and sending new messages through Claude Desktop. It provides secure, read-only access to your Mac's iMessage database and AppleScript-based message sending capabilities.
      6
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      A read-only MCP server that exposes your iMessage data to Claude Code and Claude Desktop, with automatic contact name resolution.
      3
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that exposes Apple iMessage as tools for AI assistants, enabling reading, searching, and sending iMessages through natural language.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for reading and sending iMessages on macOS. Exposes iMessage history and send capabilities through tools like list_conversations and send_imessage.
      7 npm
      MIT