Hyprmcp MCP Server-integration

Hvad gør “Hyprmcp” MCP Serveren?

Hyprmcp er en letvægts, uofficiel Model Context Protocol (MCP)-server, der eksponerer hele funktionaliteten af hyprctl, kommandolinjegrænsefladen for Hyprland Wayland-kompositøren, til sprogmodeller. Ved integration med Hyprmcp kan AI-assistenter forespørge og styre Hyprlands vinduesstyring, layouts, input og mere ved hjælp af naturligt sprog. Dette forbedrer udvikler- og brugerarbejdsgange ved at muliggøre opgaver som at hente arbejdsområdeinformation, styre monitors, køre vilkårlige Hyprland-kommandoer og indhente systemtilstand – alt sammen via en samtalebaseret AI-grænseflade. Serveren er designet til at være eksperimentel og i beta og skaber bro mellem Hyprlands omfattende kommandosæt og moderne, sprogmodel-drevne grænseflader.

Liste over prompts

Ingen prompt-skabeloner er nævnt i den tilgængelige dokumentation eller repositories.

Liste over ressourcer

Ingen eksplicitte MCP-ressourcer er dokumenteret i repository eller README.

Liste over værktøjer

• run_hyprctl_command
  Udfører vilkårlige hyprctl-kommandoer.
• get_version
  Henter Hyprland-version og build-info.
• list_monitors
  Viser alle tilsluttede monitors og deres egenskaber.
• list_workspaces
  Viser alle aktive arbejdsområder.
• list_clients
  (Ingen beskrivelse angivet, men viser sandsynligvis Hyprland-klienter/vinduer.)

Anvendelsestilfælde for denne MCP-server

• Vinduesstyring via AI
  Muliggør, at AI-assistenter kan styre og forespørge Hyprland-vinduer, layouts og arbejdsområder, hvilket effektiviserer skrivebordsorganisation.
• Automatiserede systemstatus-forespørgsler
  Udviklere kan bruge naturligt sprog til at tjekke monitor-konfigurationer, aktive arbejdsområder og klientvinduer, hvilket hjælper diagnosticering og scripting.
• Versions- og miljørevision
  Hent Hyprland-version/build-information til fejlsøgning eller dokumentation via AI-forespørgsler.
• Integration med udviklerværktøjer
  Integrér Hyprland-styring problemfrit i MCP-kompatible klienter (f.eks. Claude, Cursor) for udviklerautomatisering.
• Automatisering af brugerdefinerede arbejdsgange
  Brug vilkårlige hyprctl-kommandoer via samtalegrænseflader til avancerede, gentagelige opsætninger og arbejdsgange.

Sådan sætter du det op

Windsurf

Ingen opsætningsvejledninger eller konfigurationseksempler er tilgængelige for Windsurf.

Claude

1. Klon repository
   • git clone https://github.com/stefanoamorelli/hyprmcp.git
   • cd hyprmcp
2. Hent din HYPRLAND_INSTANCE_SIGNATURE
   • echo $HYPRLAND_INSTANCE_SIGNATURE
3. Redigér konfiguration
   • Åbn ~/.config/Claude/claude_desktop_config.json
4. Tilføj Hyprmcp MCP Server
   • Indsæt følgende JSON-udsnit:

     "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. Gem og genstart
   • Gem filen og genstart Claude Desktop for at anvende ændringerne.

Sikring af API-nøgler

Brug miljøvariabler i env-sektionen:

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

Cursor

Ingen opsætningsvejledninger eller konfigurationseksempler er tilgængelige for Cursor.

Cline

Ingen opsætningsvejledninger eller konfigurationseksempler er tilgængelige for Cline.

Sådan bruger du denne MCP i flows

Brug af MCP i FlowHunt

For at integrere MCP-servere i din FlowHunt-arbejdsgang skal du starte med at tilføje MCP-komponenten til dit flow og forbinde den til din AI-agent:

Klik på MCP-komponenten for at åbne konfigurationspanelet. I systemets MCP-konfigurationssektion indsætter du dine MCP-serveroplysninger ved at bruge dette JSON-format:

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

Når dette er konfigureret, kan AI-agenten nu bruge denne MCP som værktøj med adgang til alle dens funktioner og egenskaber. Husk at ændre “hyprmcp” til navnet på din MCP-server og erstatte URL’en med din egen server-URL.

Oversigt

Vores vurdering

Hyprmcp giver en fokuseret, nyttig bro mellem Hyprland og MCP-klienter med tydelige værktøjer og opsætning for mindst én større platform. Den mangler dog prompt-skabeloner, eksplicitte ressourcedefinitioner og bredere opsætnings-/platformsstøtte. Som et eksperimentelt projekt er det et solidt udgangspunkt for avancerede brugere og udviklere, men ville have gavn af udvidet dokumentation og ressourcestøtte.

MCP-score

VURDERING: 5/10
Solid på det grundlæggende (værktøjer, licens, kernefunktion), men mangler dokumentation for prompts/ressourcer og detaljer om opsætning på tværs af platforme.