AppleScript MCP Server

K čemu slouží “AppleScript” MCP Server?

AppleScript MCP Server je server Model Context Protocol (MCP) navržený tak, aby poskytl AI asistentům a vývojářským nástrojům možnost spouštět AppleScript kód na Macu. Funguje jako most, který umožňuje AI agentům přístup a ovládání aplikací a systémových funkcí Macu, například práci s Poznámkami, Kalendářem, Kontakty, Zprávami a dalšími. Server podporuje úkoly jako vyhledávání souborů přes Spotlight, čtení a zápis souborů, spouštění shellových příkazů a dokonce i vzdálené spuštění přes SSH. Díky lehkému a intuitivnímu návrhu je snadno integrovatelný, výrazně rozšiřuje možnosti automatizace, produktivity a vývojářského workflow uživatelů Macu tím, že programově zpřístupňuje širokou škálu funkcí macOS.

Seznam promptů

V repozitáři nejsou zdokumentovány znovupoužitelné šablony promptů. Jsou k dispozici pouze ukázkové prompty pro uživatele.

Seznam zdrojů

V dostupné dokumentaci nebo kódu nejsou popsány žádné explicitní MCP zdroje.

Seznam nástrojů

V server.js ani v dokumentaci není uveden detailní seznam nástrojů. Server umožňuje spouštění libovolného AppleScriptu, ale konkrétní nástrojové primitiva nejsou vyjmenována.

Příklady použití tohoto MCP serveru

• Automatizace Mac aplikací: Umožňuje vývojářům a AI agentům automatizovat workflow zahrnující Poznámky, Kalendář, Kontakty, Zprávy a další aplikace macOS prostřednictvím spouštění AppleScript příkazů.
• Správa souborů a systému: Umožňuje vyhledávání souborů pomocí Spotlight nebo Finderu, čtení a zápis obsahu souborů a programovou správu složek a dokumentů.
• Získávání systémových informací: Usnadňuje dotazy na stav systému, jako je procento baterie, místo na disku a běžící aplikace, což je užitečné jak pro uživatele, tak pro automatizované agenty.
• Vzdálené spouštění: Podporuje spouštění AppleScriptu vzdáleně přes SSH, což umožňuje správu Macu z jiného zařízení nebo kontejneru.
• Ovládání médií a komunikace: Nabízí ovládání přehrávání médií (např. v Apple Music) a může interagovat s komunikačními aplikacemi pro automatizaci e-mailů, zpráv či připomínek.

Jak nastavit

Windsurf

1. Ujistěte se, že máte v systému nainstalovaný Node.js.
2. Otevřete svůj konfigurační soubor Windsurf.
3. Přidejte AppleScript MCP Server do sekce mcpServers pomocí níže uvedeného JSON kódu.
4. Uložte konfiguraci a restartujte Windsurf.
5. Ověřte, že server běží a je přístupný.

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

Claude

1. Ujistěte se, že je nainstalován Node.js.
2. Najděte a otevřete konfigurační soubor Claude.
3. Přidejte MCP server dle příkladu níže.
4. Uložte konfiguraci a restartujte Claude.
5. Potvrďte, že je MCP server dostupný k použití.

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

Cursor

1. Nainstalujte Node.js do systému.
2. Otevřete konfigurační soubor Cursor.
3. Vložte záznam AppleScript MCP serveru do sekce mcpServers.
4. Uložte a restartujte Cursor.
5. Zkontrolujte úspěšnost integrace.

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

Cline

1. Ověřte, že je nainstalován Node.js.
2. Upravte konfigurační soubor Cline.
3. Přidejte konfiguraci MCP serveru dle příkladu níže.
4. Uložte změny a restartujte Cline.
5. Otestujte funkčnost MCP serveru.

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

Zabezpečení API klíčů a přihlašovacích údajů

Pro vzdálené spouštění lze citlivé informace, jako uživatelské jméno a heslo pro SSH, zadat bezpečně pomocí proměnných prostředí. Příklad:

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

Jak používat tento MCP ve flow

Použití MCP ve FlowHunt

Pro integraci MCP serverů do svého workflow ve FlowHunt přidejte MCP komponentu do flow a propojte ji se svým AI agentem:

Klikněte na komponentu MCP pro otevření panelu konfigurace. Do části systémové konfigurace MCP vložte údaje o vašem MCP serveru v tomto JSON formátu:

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

Po nastavení může AI agent využívat tento MCP jako nástroj se všemi jeho funkcemi a možnostmi. Nezapomeňte změnit “applescript_execute” na skutečný název vašeho MCP serveru a URL nahradit vlastní adresou MCP serveru.

Přehled

Na základě výše uvedených tabulek nabízí AppleScript MCP Server přímočarou, ale omezenou integraci. Jeho silnou stránkou je přímé ovládání Macu pomocí AppleScriptu. Chybí však zdokumentované šablony promptů, explicitní MCP zdroje i detailní nástrojová primitiva. Přítomnost licence, střední popularita a jasný postup nastavení jsou pozitivním aspektem. Celkově jde o velmi užitečné řešení pro danou oblast, ale hloubka dokumentace by mohla být lepší.

MCP Score