Integracja serwera MCP Hyprmcp

Co robi serwer MCP “Hyprmcp”?

Hyprmcp to lekki, nieoficjalny serwer Model Context Protocol (MCP), który udostępnia pełną funkcjonalność hyprctl, czyli interfejsu wiersza poleceń dla kompozytora Hyprland Wayland, modelom językowym. Dzięki integracji z Hyprmcp, asystenci AI mogą odpytywać i kontrolować zarządzanie oknami Hyprland, układy, wejścia i wiele więcej, używając języka naturalnego. Usprawnia to przepływy pracy deweloperów i użytkowników, umożliwiając m.in. pobieranie informacji o przestrzeniach roboczych, zarządzanie monitorami, uruchamianie dowolnych poleceń Hyprland oraz uzyskiwanie stanu systemu — wszystko przez konwersacyjny interfejs AI. Serwer jest zaprojektowany jako eksperymentalny i w fazie beta, stanowiąc pomost między bogatym zestawem poleceń Hyprland a nowoczesnymi, opartymi na modelach językowych interfejsami.

Lista promptów

W dostępnej dokumentacji oraz plikach repozytorium nie wspomniano o szablonach promptów.

Lista zasobów

W repozytorium ani README nie udokumentowano jawnych zasobów MCP.

Lista narzędzi

• run_hyprctl_command
  Wykonuje dowolne polecenia hyprctl.
• get_version
  Pobiera wersję i informacje o kompilacji Hyprland.
• list_monitors
  Wyświetla wszystkie podłączone monitory i ich właściwości.
• list_workspaces
  Wyświetla wszystkie aktywne przestrzenie robocze.
• list_clients
  (Brak opisu, najprawdopodobniej wyświetla klientów/okna Hyprland.)

Przykłady użycia tego serwera MCP

• Zarządzanie oknami przez AI
  Umożliwia asystentom AI kontrolę i odpytywanie okien, układów oraz przestrzeni roboczych Hyprland, usprawniając organizację pulpitu.
• Automatyczne zapytania o stan systemu
  Programiści mogą sprawdzać konfigurację monitorów, aktywne przestrzenie robocze i okna klientów za pomocą języka naturalnego, co ułatwia diagnostykę i skryptowanie.
• Audyt wersji i środowiska
  Pobieranie informacji o wersji/kompilacji Hyprland na potrzeby diagnostyki lub dokumentacji poprzez zapytania AI.
• Integracja z narzędziami deweloperskimi
  Płynna integracja sterowania Hyprland w klientach zgodnych z MCP (np. Claude, Cursor) dla automatyzacji deweloperskiej.
• Automatyzacja własnych przepływów pracy
  Używaj dowolnych poleceń hyprctl przez konwersacyjne interfejsy do zaawansowanych, powtarzalnych konfiguracji i przepływów.

Jak to skonfigurować

Windsurf

Brak instrukcji konfiguracji lub przykładów dla Windsurf.

Claude

1. Sklonuj repozytorium
   • git clone https://github.com/stefanoamorelli/hyprmcp.git
   • cd hyprmcp
2. Pobierz swój HYPRLAND_INSTANCE_SIGNATURE
   • echo $HYPRLAND_INSTANCE_SIGNATURE
3. Edytuj konfigurację
   • Otwórz ~/.config/Claude/claude_desktop_config.json
4. Dodaj serwer MCP Hyprmcp
   • Wstaw poniższy fragment JSON:

     "Hyperland MCP Server": {
       "command": "uv",
       "args": [
         "run",
         "--with",
         "mcp[cli]",
         "--with",
         "subprocess",
         "mcp",
         "run",
         "<global path of the repo>/hyprmcp/hyprmcp/server.py"
       ],
       "env": {
         "PYTHONPATH": "<global path of the repo>/hyprmcp",
         "HYPRLAND_INSTANCE_SIGNATURE": "<your-hyprland-instance-signature>"
       }
     }
     

5. Zapisz i zrestartuj
   • Zapisz plik i zrestartuj Claude Desktop, aby zastosować zmiany.

Zabezpieczanie kluczy API

Użyj zmiennych środowiskowych w sekcji env:

"env": {
  "HYPRLAND_INSTANCE_SIGNATURE": "<your-hyprland-instance-signature>"
}

Cursor

Brak instrukcji konfiguracji lub przykładów dla Cursor.

Cline

Brak instrukcji konfiguracji lub przykładów dla Cline.

Jak korzystać z tego MCP w przepływach

Użycie MCP w FlowHunt

Aby zintegrować serwery MCP w swoim przepływie FlowHunt, zacznij od dodania komponentu MCP do przepływu i połącz go ze swoim agentem AI:

Kliknij komponent MCP, aby otworzyć panel konfiguracyjny. W sekcji konfiguracji systemowej MCP wstaw dane serwera MCP w tym formacie JSON:

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

Po skonfigurowaniu agent AI będzie mógł używać tego MCP jako narzędzia z dostępem do wszystkich jego funkcji i możliwości. Pamiętaj, aby zamienić “hyprmcp” na faktyczną nazwę swojego serwera MCP i podać własny adres URL serwera.

Podsumowanie

Nasza opinia

Hyprmcp zapewnia skoncentrowany, przydatny most między Hyprland a klientami MCP, z jasnymi narzędziami i konfiguracją przynajmniej dla jednej głównej platformy. Brakuje jednak szablonów promptów, jawnych definicji zasobów i szerszego wsparcia dla innych platform/konfiguracji. Jako projekt eksperymentalny jest to solidny punkt wyjścia dla zaawansowanych użytkowników i deweloperów, ale zyskałby na rozbudowanej dokumentacji i wsparciu zasobów.

Ocena MCP

OCENA: 5/10
Solidny w podstawach (narzędzia, licencja, główna funkcjonalność), ale brakuje dokumentacji promptów/zasobów i szczegółów instalacji na wielu platformach.