AppleScript MCP Server

Wat doet de “AppleScript” MCP Server?

De AppleScript MCP Server is een Model Context Protocol (MCP) server, ontworpen om AI-assistenten en ontwikkeltools de mogelijkheid te geven AppleScript-code op een Mac uit te voeren. Als brug stelt het AI-agenten in staat toegang te krijgen tot en controle te krijgen over Mac-applicaties en systeemfuncties, zoals interactie met Notities, Agenda, Contacten, Berichten en meer. De server ondersteunt taken als het zoeken naar bestanden via Spotlight, lezen en schrijven van bestanden, uitvoeren van shellopdrachten en zelfs externe uitvoering via SSH. Het lichte en intuïtieve ontwerp maakt eenvoudige integratie mogelijk en verhoogt de automatisering, productiviteit en ontwikkelworkflow voor Mac-gebruikers aanzienlijk door programmatische toegang te bieden tot een breed scala aan macOS-functies.

Lijst met Prompts

Er zijn geen herbruikbare prompt-sjablonen gedocumenteerd in de repository. Alleen gebruikersgerichte voorbeeldprompts zijn aanwezig.

Lijst met Resources

Er worden geen expliciete MCP-resources beschreven in de beschikbare documentatie of code.

Lijst met Tools

Er wordt geen gedetailleerde lijst met tools gegeven in server.js of de documentatie. De server maakt uitvoering van willekeurige AppleScript mogelijk, maar specifieke toolprimitieven zijn niet opgesomd.

Gebruiksscenario’s van deze MCP Server

• Mac-applicatie-automatisering: Maakt het voor ontwikkelaars en AI-agenten mogelijk om workflows te automatiseren met Notities, Agenda, Contacten, Berichten en andere macOS-apps door AppleScript-opdrachten uit te voeren.
• Bestands- en systeembeheer: Stelt je in staat om bestanden te zoeken met Spotlight of Finder, bestanden in te lezen en te schrijven, en mappen en documenten programmatisch te beheren.
• Ophalen van systeeminformatie: Maakt het opvragen van systeemstatus zoals batterijpercentage, schijfruimte en actieve applicaties mogelijk, handig voor zowel gebruikers als geautomatiseerde agenten.
• Externe uitvoering: Ondersteunt het uitvoeren van AppleScript op afstand via SSH, zodat je een Mac vanaf een andere machine of container kunt beheren.
• Media- en communicatiebesturing: Biedt besturing over mediaplayback (bijv. in Apple Music) en kan communiceren met communicatie-apps om e-mails, berichten of herinneringen te automatiseren.

Hoe stel je het in

Windsurf

1. Zorg dat Node.js op je systeem is geïnstalleerd.
2. Open je Windsurf-configuratiebestand.
3. Voeg de AppleScript MCP Server toe aan je mcpServers-sectie met de onderstaande JSON-snippet.
4. Sla de configuratie op en herstart Windsurf.
5. Controleer of de server draait en bereikbaar is.

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

Claude

1. Zorg dat Node.js is geïnstalleerd.
2. Zoek en open het configuratiebestand van Claude.
3. Voeg de MCP-server toe zoals in het onderstaande voorbeeld.
4. Sla het bestand op en herstart Claude.
5. Bevestig dat de MCP-server beschikbaar is voor gebruik.

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

Cursor

1. Installeer Node.js op je systeem.
2. Open het configuratiebestand van Cursor.
3. Voeg de AppleScript MCP-server toe aan de sectie mcpServers.
4. Sla op en herstart Cursor.
5. Controleer of de integratie succesvol is.

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

Cline

1. Controleer of Node.js is geïnstalleerd.
2. Bewerk het configuratiebestand van Cline.
3. Voeg de MCP-serverconfiguratie toe zoals in het onderstaande voorbeeld.
4. Sla wijzigingen op en herstart Cline.
5. Test of de MCP-server werkt.

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

API-sleutels en inloggegevens beveiligen

Voor externe uitvoering kunnen gevoelige gegevens zoals SSH-gebruikersnamen en -wachtwoorden via omgevingsvariabelen worden opgegeven voor betere beveiliging. Voorbeeld:

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

Hoe gebruik je deze MCP in flows

MCP gebruiken in FlowHunt

Om MCP-servers in je FlowHunt-workflow te integreren, voeg je het MCP-component toe aan je flow en verbind je deze met je AI-agent:

Klik op het MCP-component om het configuratiepaneel te openen. Voeg in de systeem-MCP-configuratie je MCP-serverdetails toe met dit JSON-formaat:

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

Na configuratie kan de AI-agent deze MCP nu als tool gebruiken met toegang tot alle functies en mogelijkheden. Vergeet niet “applescript_execute” te wijzigen naar de daadwerkelijke naam van je MCP-server en de URL te vervangen door jouw MCP-server-URL.

Overzicht

Op basis van bovenstaande tabel biedt de AppleScript MCP Server een eenvoudige maar beperkte integratie. De kracht ligt in directe besturing van de Mac via AppleScript. Er ontbreken echter gedocumenteerde prompt-sjablonen, expliciete MCP-resources en gedetailleerde toolprimitieven. De aanwezigheid van een licentie, redelijke populariteit en duidelijke installatie-instructies zijn pluspunten. Al met al is het zeer nuttig binnen zijn niche, maar de documentatie zou beter kunnen.

MCP Score