iMCP

iMCP ist eine macOS-App, die Ihr digitales Leben mit KI verbindet. Sie ist mit Claude Desktop und einer wachsenden Liste von Clients kompatibel, die das Model Context Protocol (MCP) unterstützen.

Funktionen

[!TIP] Haben Sie einen Vorschlag für eine neue Funktion? Kontaktieren Sie uns unter imcp@loopwork.com

Erste Schritte

Laden Sie die App herunter und öffnen Sie sie

Laden Sie zunächst die iMCP-App herunter (erfordert macOS 15.3 oder höher).

Wenn Sie die App öffnen, sehen Sie ein Symbol in Ihrer Menüleiste.

Ein Klick auf dieses Symbol öffnet das iMCP-Menü mit allen verfügbaren Diensten. Alle Dienste sind zunächst grau dargestellt, was bedeutet, dass sie inaktiv sind.

Der blaue Kippschalter oben zeigt an, dass der MCP-Server ausgeführt wird und bereit ist, eine Verbindung mit MCP-kompatiblen Clients herzustellen.

Dienste aktivieren

Um einen Dienst zu aktivieren, klicken Sie auf das entsprechende Symbol. Das System zeigt Ihnen daraufhin einen Berechtigungsdialog an. Beispielsweise wird beim Aktivieren des Kalenderzugriffs die Frage "iMCP" Would Like Full Access to Your Calendar angezeigt. Klicken Sie auf „Vollzugriff zulassen“, um fortzufahren.

[!WICHTIG] iMCP sammelt oder speichert keine Ihrer Daten. Clients wie Claude Desktop senden Ihre Daten im Rahmen von Tool-Aufrufen vom Gerät.

Nach der Aktivierung wechselt die Farbe der einzelnen Dienstsymbole von Grau zu ihrer jeweiligen Farbe – Rot für Kalender, Grün für Nachrichten, Blau für Standort usw.

Wiederholen Sie diesen Vorgang für alle Funktionen, die Sie aktivieren möchten. Diese Berechtigungen folgen dem Standardsicherheitsmodell von Apple und geben Ihnen die vollständige Kontrolle darüber, auf welche Informationen iMCP zugreifen kann.

Verbinden Sie sich mit Claude Desktop

Wenn Sie Claude Desktop nicht installiert haben, können Sie es hier herunterladen .

Öffnen Sie Claude Desktop und gehen Sie zu „Einstellungen… (⌘,)“. Klicken Sie in der Seitenleiste des Einstellungsbereichs auf „Entwickler“ und anschließend auf „Konfiguration bearbeiten“. Dadurch wird eine Konfigurationsdatei unter ~/Library/Application Support/Claude/claude_desktop_config.json erstellt.

Um iMCP mit Claude Desktop zu verbinden, klicken Sie auf > „Claude Desktop konfigurieren“.

Dadurch wird die MCP-Serverkonfiguration hinzugefügt oder aktualisiert, um die in der Anwendung enthaltene ausführbare imcp-server zu verwenden. Andere MCP-Serverkonfigurationen in der Datei bleiben erhalten.

Klicken Sie auf > „Serverbefehl in die Zwischenablage kopieren“. Öffnen Sie anschließend claude_desktop_config.json in Ihrem Editor und geben Sie Folgendes ein:

Rufen Sie iMCP-Tools von Claude Desktop aus auf

Beenden Sie die Claude Desktop-App und öffnen Sie sie erneut. Sie werden aufgefordert, die Verbindung zu bestätigen.

[!NOTE] Dieses Dialogfeld wird möglicherweise zweimal angezeigt. Klicken Sie beide Male auf „Genehmigen“.

Nachdem Sie die Verbindung bestätigt haben, sollten Sie unten rechts in Ihrem Chatfenster 🔨12 sehen. Klicken Sie darauf, um eine Liste aller Tools anzuzeigen, die Claude von iMCP zur Verfügung gestellt wurden.

Jetzt können Sie Claude Fragen stellen, für die Sie Zugriff auf Ihre personenbezogenen Daten benötigen, beispielsweise:

„Wie ist das Wetter bei mir?“

Claude verwendet die entsprechenden Tools, um diese Informationen abzurufen und Ihnen genaue, personalisierte Antworten zu geben, ohne dass Sie diese Daten während Ihres Gesprächs manuell weitergeben müssen.

Technische Details

App und CLI

iMCP ist eine macOS-App, die eine ausführbare Befehlszeilendatei namens imcp-server bündelt.

• iMCP.app bietet eine Benutzeroberfläche zum Konfigurieren von Diensten und – was am wichtigsten ist – eine Möglichkeit zur Interaktion mit den Systemberechtigungen von macOS, sodass auf Kontakte, Kalender und andere Informationen zugegriffen werden kann.
• imcp-server stellt einen MCP-Server bereit, der Standard-Eingabe/Ausgabe für die Kommunikation verwendet ( stdio-Transport ).

App und CLI kommunizieren im lokalen Netzwerk über Bonjour zur automatischen Erkennung miteinander. Beide bieten einen Dienst mit dem Typ „_mcp._tcp“ und der Domäne „local“ an. Anfragen von MCP-Clients werden von der CLI von stdin gelesen und an die App weitergeleitet; Antworten der App werden von der CLI empfangen und in stdout geschrieben. Details zur Implementierung finden Sie unter StdioProxy .

Für dieses Projekt haben wir mcp-swift-sdk entwickelt: ein Swift SDK für Model Context Protocol-Server und -Clients. Die App verwendet dieses Paket, um Proxy-Anfragen von MCP-Clients zu verarbeiten.

Zugriff auf die iMessage-Datenbank

Apple stellt keine öffentlichen APIs für den Zugriff auf Ihre Nachrichten bereit. Die Nachrichten-App unter macOS speichert Daten jedoch in einer SQLite-Datenbank unter ~/Library/Messages/chat.db .

iMCP läuft in der App-Sandbox , was den Zugriff auf Benutzerdaten und Systemressourcen beschränkt. Wenn Sie den Nachrichtendienst aktivieren, werden Sie aufgefordert, die Datei chat.db über die Standard-Dateiauswahl zu öffnen. Wenn Sie dies tun, fügt macOS diese Datei der Sandbox der App hinzu. NSOpenPanel ist so magisch.

Doch das Öffnen der iMessage-Datenbank ist nur die halbe Miete. In den letzten Jahren hat Apple sich von der Speicherung von Nachrichten im Klartext verabschiedet und stattdessen ein proprietäres typedstream Format verwendet.

Für dieses Projekt haben wir „Madrid“ entwickelt: ein Swift-Paket zum Lesen Ihrer iMessage-Datenbank. Es enthält eine Swift-Implementierung zum Dekodieren typedstream Formats von Apple, adaptiert aus Christopher Sardegnas Projekt „iMessage-Exporter“ und einem Blogbeitrag über Reverse Engineering typedstream .

JSON-LD für Tool-Ergebnisse

Die von iMCP bereitgestellten Tools geben Ergebnisse als JSON-LD -Dokumente zurück. Beispielsweise verwendet das Tool fetchContacts das Contacts-Framework , das Personen und Organisationen mit dem Typ CNContact darstellt. So wird ein Objekt dieses Typs als JSON-LD kodiert:

Schema.org bietet Standardvokabulare für Personen, Postadressen, Ereignisse und viele weitere Objekte, die wir darstellen möchten. Und JSON-LD ist ein praktisches Kodierungsformat für Menschen, KI und konventionelle Software gleichermaßen.

Für dieses Projekt haben wir Ontology entwickelt: ein Swift-Paket für die Arbeit mit strukturierten Daten. Es enthält praktische Initialisierer für Typen aus Apple-Frameworks, wie sie beispielsweise von iMCP-Tools zurückgegeben werden.

Debuggen

Verwenden des MCP-Inspektors

Zum Debuggen von Interaktionen zwischen iMCP und Clients können Sie das Inspector-Tool verwenden (erfordert Node.js):

1. Klicken Sie auf > „Serverbefehl in die Zwischenablage kopieren“
2. Öffnen Sie ein Terminal und führen Sie die folgenden Befehle aus:
   # Download and run inspector package on imcp-server npx @modelcontextprotocol/inspector [paste-copied-command] # Open inspector web app running locally open http://127.0.0.1:6274

Mit diesem Tool können Sie alle Anfragen und Antworten zwischen dem Client und dem iMCP-Server sehen, was hilfreich ist, um zu verstehen, wie das Protokoll funktioniert.

Danksagung

• Justin Spahr-Summers ( @jspahrsummers ), David Soria Parra ( @dsp-ant ) und Ashwin Bhat ( @ashwin-ant ) für ihre Arbeit an MCP.
• Christopher Sardegna ( @ReagentX ) für das Reverse Engineering des von der Nachrichten-App verwendeten typedstream -Formats.

Lizenz

Dieses Projekt ist unter der Apache-Lizenz, Version 2.0, lizenziert.

Rechtliches

iMessage® ist eine eingetragene Marke von Apple Inc.
Dieses Projekt steht in keiner Verbindung zu Apple Inc. und wird von Apple Inc. auch nicht unterstützt oder gesponsert.