AppleScript MCP Server

Was macht der “AppleScript” MCP Server?

Der AppleScript MCP Server ist ein Model Context Protocol (MCP) Server, der darauf ausgelegt ist, KI-Assistenten und Entwicklungstools die Möglichkeit zu geben, AppleScript-Code auf einem Mac auszuführen. Als Brücke ermöglicht er KI-Agenten den Zugriff auf und die Steuerung von Mac-Anwendungen und Systemfunktionen, wie etwa das Interagieren mit Notizen, Kalender, Kontakten, Nachrichten und vielem mehr. Der Server unterstützt Aufgaben wie das Durchsuchen von Dateien via Spotlight, das Lesen und Schreiben von Dateien, das Ausführen von Shell-Befehlen und sogar die Remote-Ausführung über SSH. Sein leichtgewichtiges und intuitives Design macht die Integration einfach und steigert die Automatisierung, Produktivität und Entwicklungs-Workflows für Mac-Nutzer erheblich, indem er programmatischen Zugriff auf eine breite Palette von macOS-Funktionen ermöglicht.

Liste der Prompts

Im Repository sind keine wiederverwendbaren Prompt-Templates dokumentiert. Es werden nur benutzerorientierte Beispielprompts bereitgestellt.

Liste der Ressourcen

In der verfügbaren Dokumentation oder im Code werden keine expliziten MCP-Ressourcen beschrieben.

Liste der Tools

Es gibt keine detaillierte Tool-Auflistung in server.js oder der Dokumentation. Der Server ermöglicht die Ausführung beliebiger AppleScript-Befehle, aber spezifische Tool-Primitives sind nicht aufgezählt.

Anwendungsfälle dieses MCP Servers

• Mac-Anwendungsautomatisierung: Entwicklern und KI-Agenten wird ermöglicht, Workflows mit Notizen, Kalender, Kontakten, Nachrichten und anderen macOS-Apps zu automatisieren, indem sie AppleScript-Befehle ausführen.
• Datei- und Systemmanagement: Suchen von Dateien mit Spotlight oder Finder, Lesen und Schreiben von Dateiinhalten sowie programmatische Verwaltung von Ordnern und Dokumenten.
• Abruf von Systeminformationen: Abfragen von Systemstatus wie Akkustand, Speicherplatz und laufenden Anwendungen – nützlich für Benutzer und automatisierte Agenten.
• Remote-Ausführung: Unterstützt die Ausführung von AppleScript aus der Ferne via SSH und ermöglicht so die Verwaltung eines Macs von einer anderen Maschine oder aus einem Container.
• Medien- und Kommunikationssteuerung: Bietet Kontrolle über die Medienwiedergabe (z. B. in Apple Music) und kann mit Kommunikations-Apps interagieren, um E-Mails, Nachrichten oder Erinnerungen zu automatisieren.

So richten Sie es ein

Windsurf

1. Stellen Sie sicher, dass Node.js auf Ihrem System installiert ist.
2. Öffnen Sie Ihre Windsurf-Konfigurationsdatei.
3. Fügen Sie den AppleScript MCP Server im Abschnitt mcpServers mit folgendem JSON-Snippet hinzu.
4. Speichern Sie die Konfiguration und starten Sie Windsurf neu.
5. Überprüfen Sie, ob der Server läuft und erreichbar ist.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Claude

1. Stellen Sie sicher, dass Node.js installiert ist.
2. Suchen und öffnen Sie die Claude-Konfigurationsdatei.
3. Fügen Sie den MCP-Server wie im Beispiel unten hinzu.
4. Speichern Sie die Konfiguration und starten Sie Claude neu.
5. Bestätigen Sie, dass der MCP-Server verfügbar ist.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cursor

1. Installieren Sie Node.js auf Ihrem System.
2. Öffnen Sie die Konfigurationsdatei von Cursor.
3. Fügen Sie den Eintrag für den AppleScript MCP Server in den Abschnitt mcpServers ein.
4. Speichern und starten Sie Cursor neu.
5. Überprüfen Sie die erfolgreiche Integration.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cline

1. Vergewissern Sie sich, dass Node.js installiert ist.
2. Bearbeiten Sie die Cline-Konfigurationsdatei.
3. Fügen Sie die MCP-Server-Konfiguration wie im Beispiel unten hinzu.
4. Speichern Sie die Änderungen und starten Sie Cline neu.
5. Testen Sie, ob der MCP-Server funktioniert.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

API-Schlüssel und Zugangsdaten absichern

Für die Remote-Ausführung können sensible Informationen wie SSH-Benutzernamen und Passwörter aus Sicherheitsgründen über Umgebungsvariablen bereitgestellt werden. Beispiel:

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ],
      "env": {
        "REMOTE_USER": "yourusername",
        "REMOTE_PASSWORD": "yourpassword"
      },
      "inputs": {
        "remoteHost": "host.docker.internal"
      }
    }
  }
}

Verwendung dieses MCP in Flows

MCP in FlowHunt nutzen

Um MCP-Server in Ihren FlowHunt-Workflow zu integrieren, fügen Sie zunächst die MCP-Komponente zu Ihrem Flow hinzu und verbinden Sie sie mit Ihrem KI-Agenten:

Klicken Sie auf die MCP-Komponente, um das Konfigurationspanel zu öffnen. Im System-MCP-Konfigurationsbereich fügen Sie Ihre MCP-Serverdetails im folgenden JSON-Format ein:

{
  "applescript_execute": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Nach der Konfiguration kann der KI-Agent dieses MCP als Tool mit Zugriff auf alle Funktionen und Möglichkeiten nutzen. Denken Sie daran, “applescript_execute” durch den tatsächlichen Namen Ihres MCP-Servers zu ersetzen und die URL an Ihre eigene MCP-Server-Adresse anzupassen.

Übersicht

Basierend auf den obigen Tabellen bietet der AppleScript MCP Server eine unkomplizierte, aber begrenzte Integration. Seine Stärke liegt in der direkten Steuerung des Macs über AppleScript. Es fehlen jedoch dokumentierte Prompt-Templates, explizite MCP-Ressourcen und detaillierte Tool-Primitives. Die vorhandene Lizenz, die moderate Beliebtheit und die klaren Einrichtungsanleitungen sind Pluspunkte. Insgesamt ist er für seinen speziellen Anwendungsbereich sehr nützlich, aber die Dokumentation könnte ausführlicher sein.

MCP-Bewertung