Hyprmcp MCP Server Integrace

Co dělá “Hyprmcp” MCP server?

Hyprmcp je lehký, neoficiální Model Context Protocol (MCP) server, který zpřístupňuje plnou funkcionalitu hyprctl, příkazové řádky pro Hyprland Wayland compositor, jazykovým modelům. Díky integraci s Hyprmcp mohou AI asistenti dotazovat a ovládat správu oken, rozložení, vstupy a další funkce Hyprlandu pomocí přirozeného jazyka. To zlepšuje pracovní postupy vývojářů i uživatelů – umožňuje například získávat informace o pracovních plochách, spravovat monitory, spouštět libovolné příkazy Hyprland nebo získávat stav systému – vše přes konverzační AI rozhraní. Server je navržen jako experimentální a v beta verzi a tvoří most mezi bohatou sadou příkazů Hyprlandu a moderními rozhraními ovládanými jazykovými modely.

Seznam promptů

V dostupné dokumentaci ani souborech repozitáře nejsou zmíněny žádné šablony promptů.

Seznam zdrojů

V repozitáři ani README nejsou zdokumentovány žádné explicitní MCP zdroje.

Seznam nástrojů

• run_hyprctl_command
  Spouští libovolné příkazy hyprctl.
• get_version
  Získá informace o verzi a buildu Hyprlandu.
• list_monitors
  Vypíše všechny připojené monitory a jejich vlastnosti.
• list_workspaces
  Vypíše všechny aktivní pracovní plochy.
• list_clients
  (Popis není uveden, pravděpodobně vypíše klienty/okna Hyprlandu.)

Příklady využití tohoto MCP serveru

• Správa oken pomocí AI
  Umožňuje AI asistentům ovládat a dotazovat se na okna, rozložení a pracovní plochy v Hyprlandu, což zjednodušuje organizaci desktopu.
• Automatizované dotazy na stav systému
  Vývojáři mohou pomocí přirozeného jazyka kontrolovat konfigurace monitorů, aktivní pracovní plochy i klientská okna, což usnadňuje diagnostiku a skriptování.
• Audit verze a prostředí
  Získávání informací o verzi/buildu Hyprlandu pro účely troubleshooting nebo dokumentace přes AI dotazy.
• Integrace s vývojářskými nástroji
  Plynulá integrace ovládání Hyprlandu do MCP-kompatibilních klientů (např. Claude, Cursor) pro automatizaci vývoje.
• Vlastní workflow automatizace
  Použití libovolných příkazů hyprctl přes konverzační rozhraní pro pokročilá, opakovatelná nastavení a workflow.

Jak to nastavit

Windsurf

Pro Windsurf nejsou uvedeny žádné instalační instrukce ani příklady konfigurace.

Claude

1. Naklonujte repozitář
   • git clone https://github.com/stefanoamorelli/hyprmcp.git
   • cd hyprmcp
2. Získejte svůj HYPRLAND_INSTANCE_SIGNATURE
   • echo $HYPRLAND_INSTANCE_SIGNATURE
3. Upravte konfiguraci
   • Otevřete ~/.config/Claude/claude_desktop_config.json
4. Přidejte Hyprmcp MCP server
   • Vložte následující JSON úryvek:

     "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. Uložte a restartujte
   • Uložte soubor a restartujte Claude Desktop, aby se změny projevily.

Zabezpečení API klíčů

Používejte proměnné prostředí v sekci env:

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

Cursor

Pro Cursor nejsou uvedeny žádné instalační instrukce ani příklady konfigurace.

Cline

Pro Cline nejsou uvedeny žádné instalační instrukce ani příklady konfigurace.

Jak použít tento MCP uvnitř flow

Použití MCP ve FlowHunt

Pro integraci MCP serverů do svého pracovního postupu ve FlowHunt začněte přidáním MCP komponenty do svého flow a propojením s AI agentem:

Klikněte na MCP komponentu pro otevření panelu konfigurace. V sekci systémové konfigurace MCP vložte detaily vašeho serveru v tomto JSON formátu:

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

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

Přehled

Náš názor

Hyprmcp nabízí užitečný a cílený most mezi Hyprlandem a MCP klienty s jasnými nástroji a návodem pro alespoň jednu hlavní platformu. Chybí mu však šablony promptů, explicitní definice zdrojů a širší podpora nastavení/platform. Jakožto experimentální projekt je solidním výchozím bodem pro pokročilé uživatele a vývojáře, ale přivítali bychom rozšířenou dokumentaci a podporu zdrojů.

MCP skóre

HODNOCENÍ: 5/10
Dobré základy (nástroje, licence, základní funkce), ale chybí dokumentace promptů/zdrojů a detaily pro nastavení na více platformách.