AppleScript MCP Server

Co robi “AppleScript” MCP Server?

AppleScript MCP Server to serwer Model Context Protocol (MCP), zaprojektowany, by zapewnić asystentom AI i narzędziom programistycznym możliwość uruchamiania kodu AppleScript na komputerze Mac. Działa jako most, umożliwiając agentom AI dostęp i kontrolę nad aplikacjami Maca oraz funkcjami systemowymi, takimi jak interakcja z Notatkami, Kalendarzem, Kontaktami, Wiadomościami i innymi. Serwer obsługuje zadania takie jak wyszukiwanie plików przez Spotlight, odczytywanie i zapisywanie plików, wykonywanie poleceń powłoki, a nawet zdalne wykonywanie przez SSH. Jego lekka i intuicyjna konstrukcja sprawia, że integracja jest łatwa, znacząco zwiększając automatyzację, produktywność i workflow rozwojowy użytkowników Maca poprzez programistyczny dostęp do szerokiej gamy funkcji macOS.

Lista promptów

W repozytorium nie udokumentowano wielokrotnego użytku szablonów promptów. Dostępne są jedynie przykłady promptów skierowane do użytkownika.

Lista zasobów

W dostępnej dokumentacji ani kodzie nie opisano jawnych zasobów MCP.

Lista narzędzi

W pliku server.js ani dokumentacji nie przedstawiono szczegółowej listy narzędzi. Serwer umożliwia wykonywanie dowolnych poleceń AppleScript, jednak konkretne prymitywy narzędzi nie są wymienione.

Przykłady użycia tego serwera MCP

• Automatyzacja aplikacji Maca: Pozwala deweloperom i agentom AI automatyzować workflow obejmujące Notatki, Kalendarz, Kontakty, Wiadomości i inne aplikacje macOS poprzez wykonywanie poleceń AppleScript.
• Zarządzanie plikami i systemem: Umożliwia wyszukiwanie plików za pomocą Spotlight lub Findera, odczytywanie i zapisywanie zawartości plików oraz programistyczne zarządzanie folderami i dokumentami.
• Pobieranie informacji o systemie: Ułatwia pobieranie statusu systemu, takiego jak poziom baterii, wolne miejsce na dysku, uruchomione aplikacje – przydatne zarówno dla użytkowników, jak i agentów automatyzujących pracę.
• Zdalne wykonywanie: Obsługuje wykonywanie AppleScript zdalnie przez SSH, umożliwiając zarządzanie Maciem z innego komputera lub kontenera.
• Kontrola multimediów i komunikacji: Zapewnia kontrolę nad odtwarzaniem mediów (np. w Apple Music) oraz możliwość interakcji z aplikacjami komunikacyjnymi w celu automatyzacji e-maili, wiadomości lub przypomnień.

Jak to skonfigurować

Windsurf

1. Upewnij się, że na Twoim systemie jest zainstalowany Node.js.
2. Otwórz plik konfiguracyjny Windsurf.
3. Dodaj AppleScript MCP Server do sekcji mcpServers używając poniższego fragmentu JSON.
4. Zapisz konfigurację i zrestartuj Windsurf.
5. Sprawdź, czy serwer działa i jest dostępny.

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

Claude

1. Upewnij się, że Node.js jest zainstalowany.
2. Zlokalizuj i otwórz plik konfiguracyjny Claude.
3. Dodaj serwer MCP jak w poniższym przykładzie.
4. Zapisz konfigurację i zrestartuj Claude.
5. Potwierdź dostępność serwera MCP.

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

Cursor

1. Zainstaluj Node.js na swoim systemie.
2. Otwórz plik konfiguracyjny Cursor.
3. Wstaw wpis serwera AppleScript MCP do sekcji mcpServers.
4. Zapisz i zrestartuj Cursor.
5. Sprawdź, czy integracja przebiegła pomyślnie.

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

Cline

1. Zweryfikuj, że Node.js jest zainstalowany.
2. Edytuj plik konfiguracyjny Cline.
3. Dodaj konfigurację serwera MCP według poniższego przykładu.
4. Zapisz zmiany i zrestartuj Cline.
5. Przetestuj poprawność działania serwera MCP.

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

Bezpieczne przechowywanie kluczy API i danych uwierzytelniających

Do zdalnego wykonywania wrażliwe informacje, takie jak nazwa użytkownika i hasło SSH, można przekazywać przez zmienne środowiskowe dla większego bezpieczeństwa. Przykład:

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

Jak używać tego MCP w flows

Użycie MCP w FlowHunt

Aby zintegrować serwery MCP w swoim workflow FlowHunt, zacznij od dodania komponentu MCP do swojego flow i połącz go z agentem AI:

Kliknij na komponent MCP, by otworzyć panel konfiguracji. W sekcji konfiguracji systemowej MCP wklej dane swojego serwera MCP w tym formacie JSON:

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

Po skonfigurowaniu agent AI może korzystać z tego MCP jako narzędzia ze wszystkimi jego funkcjami i możliwościami. Pamiętaj, aby zmienić “applescript_execute” na faktyczną nazwę swojego serwera MCP i zastąpić URL własnym adresem serwera.

Przegląd

Na podstawie powyższych zestawień AppleScript MCP Server oferuje prostą, ale ograniczoną integrację. Jego siłą jest bezpośrednia kontrola Maca przez AppleScript. Brakuje jednak udokumentowanych szablonów promptów, jawnych zasobów MCP i szczegółowych prymitywów narzędziowych. Obecność licencji, umiarkowana popularność oraz przejrzyste instrukcje konfiguracji to pozytywy. Ogólnie rzecz biorąc, jest bardzo użyteczny dla swojej niszy, ale dokumentacja mogłaby być bardziej rozbudowana.

Ocena MCP