Integrácia Hyprmcp MCP servera

Čo robí MCP server “Hyprmcp”?

Hyprmcp je odľahčený neoficiálny Model Context Protocol (MCP) server, ktorý sprístupňuje všetky funkcie hyprctl, príkazového rozhrania pre Hyprland Wayland kompozítor, jazykovým modelom. Integráciou s Hyprmcp môžu AI asistenti dotazovať a ovládať správu okien, rozloženia, vstupy a ďalšie funkcie Hyprlandu pomocou prirodzeného jazyka. Zjednodušuje vývojárske aj užívateľské workflowy – umožňuje získavať informácie o pracoviskách, spravovať monitory, vykonávať ľubovoľné Hyprland príkazy a získavať stav systému – to všetko prostredníctvom AI rozhrania v konverzácii. Server je navrhnutý ako experimentálny a v beta verzii a slúži ako most medzi bohatou príkazovou sadou Hyprland a modernými rozhraniami poháňanými jazykovými modelmi.

Zoznam promptov

V dostupnej dokumentácii alebo súboroch repozitára nie sú uvedené žiadne šablóny promptov.

Zoznam zdrojov

V repozitári ani README nie sú zdokumentované explicitné MCP zdroje.

Zoznam nástrojov

• run_hyprctl_command
  Spustí ľubovoľný príkaz hyprctl.
• get_version
  Získa informácie o verzii a zostave Hyprlandu.
• list_monitors
  Vypíše všetky pripojené monitory a ich vlastnosti.
• list_workspaces
  Vypíše všetky aktívne pracoviská.
• list_clients
  (Nie je zadaný popis, pravdepodobne vypíše Hyprland klientov/okná.)

Príklady použitia tohto MCP servera

• Správa okien pomocou AI
  Umožňuje AI asistentom ovládať a dotazovať sa na okná, rozloženia a pracoviská Hyprlandu, čím zjednodušuje organizáciu desktopu.
• Automatizované dotazy na stav systému
  Vývojári môžu pomocou prirodzeného jazyka zistiť konfiguráciu monitorov, aktívne pracoviská a klientské okná, čo uľahčuje diagnostiku a skriptovanie.
• Audit verzie a prostredia
  Získajte informácie o verzii/zostave Hyprlandu pre troubleshooting alebo dokumentáciu cez AI dotazy.
• Integrácia s vývojárskymi nástrojmi
  Bezproblémovo integrujte ovládanie Hyprlandu do MCP-kompatibilných klientov (napr. Claude, Cursor) pre vývojársku automatizáciu.
• Automatizácia vlastných workflowov
  Spúšťajte ľubovoľné príkazy hyprctl cez konverzačné rozhrania pre pokročilé a opakovateľné nastavenia a workflowy.

Ako to nastaviť

Windsurf

Pre Windsurf nie sú uvedené žiadne inštrukcie na nastavenie ani príklady konfigurácie.

Claude

1. Klonujte repozitár
   • git clone https://github.com/stefanoamorelli/hyprmcp.git
   • cd hyprmcp
2. Zistite svoje HYPRLAND_INSTANCE_SIGNATURE
   • echo $HYPRLAND_INSTANCE_SIGNATURE
3. Upravte konfiguráciu
   • Otvorte ~/.config/Claude/claude_desktop_config.json
4. Pridajte Hyprmcp MCP server
   • Pridajte nasledujúci JSON úsek:

     "Hyperland MCP Server": {
       "command": "uv",
       "args": [
         "run",
         "--with",
         "mcp[cli]",
         "--with",
         "subprocess",
         "mcp",
         "run",
         "<globálna cesta k repozitáru>/hyprmcp/hyprmcp/server.py"
       ],
       "env": {
         "PYTHONPATH": "<globálna cesta k repozitáru>/hyprmcp",
         "HYPRLAND_INSTANCE_SIGNATURE": "<váš-hyprland-instance-signature>"
       }
     }
     

5. Uložte a reštartujte
   • Uložte súbor a reštartujte Claude Desktop, aby sa zmeny prejavili.

Zabezpečenie API kľúčov

Používajte environmentálne premenné v sekcii env:

"env": {
  "HYPRLAND_INSTANCE_SIGNATURE": "<váš-hyprland-instance-signature>"
}

Cursor

Pre Cursor nie sú uvedené žiadne inštrukcie na nastavenie ani príklady konfigurácie.

Cline

Pre Cline nie sú uvedené žiadne inštrukcie na nastavenie ani príklady konfigurácie.

Ako používať tento MCP vo flowoch

Používanie MCP vo FlowHunt

Na integráciu MCP serverov do vášho FlowHunt workflowu začnite pridaním MCP komponentu do flowu a prepojením s vaším AI agentom:

Kliknite na MCP komponent, aby ste otvorili konfiguračný panel. V sekcii systémovej konfigurácie MCP vložte detaily vášho MCP servera v tomto JSON formáte:

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

Po nakonfigurovaní je AI agent schopný používať tento MCP ako nástroj so všetkými jeho funkciami a schopnosťami. Nezabudnite zmeniť “hyprmcp” na skutočný názov vášho MCP servera a URL na vašu vlastnú adresu servera.

Prehľad

Náš názor

Hyprmcp poskytuje zameraný, užitočný most medzi Hyprland a MCP klientmi s jasnými nástrojmi a nastavením aspoň pre jednu hlavnú platformu. Chýbajú mu však šablóny promptov, explicitné resource definície a širšia podpora pre nastavenie/viac platforiem. Ako experimentálny projekt je to solídny začiatok pre pokročilých používateľov a vývojárov, ale prospelo by mu rozšírenie dokumentácie a podpory zdrojov.

MCP skóre

HODNOTENIE: 5/10
Silný v základoch (nástroje, licencia, jadrová funkcia), ale chýba dokumentácia promptov/zdrojov a detaily nastavenia pre viaceré platformy.