Hyprmcp MCP Server-integrasjon

Hva gjør “Hyprmcp” MCP Server?

Hyprmcp er en lettvekts, uoffisiell Model Context Protocol (MCP) server som eksponerer all funksjonalitet til hyprctl, kommandolinjegrensesnittet for Hyprland Wayland-komposittøren, for språkmodeller. Ved å integrere med Hyprmcp kan AI-assistenter spørre og styre Hyprlands vindusadministrasjon, oppsett, inndata og mer, med naturlig språk. Dette forbedrer arbeidsflyten for utviklere og brukere ved å gjøre det mulig å hente arbeidsflateinformasjon, administrere skjermer, kjøre vilkårlige Hyprland-kommandoer og hente systemstatus – alt gjennom et samtale-AI-grensesnitt. Serveren er designet som eksperimentell og i beta, og fungerer som bro mellom Hyprlands rike kommandosett og moderne, språkmodell-drevne grensesnitt.

Liste over prompt-maler

Ingen prompt-maler er nevnt i tilgjengelig dokumentasjon eller repository-filer.

Liste over ressurser

Ingen eksplisitte MCP-ressurser er dokumentert i repository eller README.

Liste over verktøy

• run_hyprctl_command
  Utfører vilkårlige hyprctl-kommandoer.
• get_version
  Henter Hyprland-versjon og byggeinformasjon.
• list_monitors
  Lister alle tilkoblede skjermer og deres egenskaper.
• list_workspaces
  Lister alle aktive arbeidsflater.
• list_clients
  (Ingen beskrivelse gitt, men lister sannsynligvis Hyprland-klienter/vinduer.)

Bruksområder for denne MCP-serveren

• Vindusadministrasjon via AI
  Gjør det mulig for AI-assistenter å styre og spørre Hyprland-vinduer, oppsett og arbeidsflater, og effektivisere organisering av skrivebordet.
• Automatiserte systemstatusspørringer
  Utviklere kan bruke naturlig språk for å sjekke skjermkonfigurasjoner, aktive arbeidsflater og klientvinduer, som hjelper med diagnostikk og skripting.
• Versjons- og miljørevisjon
  Hent Hyprland-versjon/byggeinformasjon for feilsøking eller dokumentasjon via AI-spørringer.
• Integrasjon med utviklerverktøy
  Integrer Hyprland-kontroll sømløst i MCP-kompatible klienter (f.eks. Claude, Cursor) for utviklerautomatisering.
• Tilpasset arbeidsflytautomatisering
  Bruk vilkårlige hyprctl-kommandoer gjennom samtalegrensesnitt for avanserte, repeterbare oppsett og arbeidsflyter.

Slik settes det opp

Windsurf

Ingen oppsettinstruksjoner eller konfigurasjonseksempler er gitt 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. Rediger konfigurasjon
   • Åpne ~/.config/Claude/claude_desktop_config.json
4. Legg til Hyprmcp MCP-server
   • Sett inn følgende JSON-snutt:

     "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. Lagre og start på nytt
   • Lagre filen og start Claude Desktop på nytt for at endringene skal tre i kraft.

Sikring av API-nøkler

Bruk miljøvariabler i env-seksjonen:

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

Cursor

Ingen oppsettinstruksjoner eller konfigurasjonseksempler er gitt for Cursor.

Cline

Ingen oppsettinstruksjoner eller konfigurasjonseksempler er gitt for Cline.

Slik bruker du denne MCP-en i flows

Bruke MCP i FlowHunt

For å integrere MCP-servere i din FlowHunt-arbeidsflyt, start med å legge til MCP-komponenten i din flow og koble den til din AI-agent:

Klikk på MCP-komponenten for å åpne konfigurasjonspanelet. I system-MCP-konfigurasjonsseksjonen legger du inn MCP-serverdetaljene dine med dette JSON-formatet:

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

Når dette er konfigurert, kan AI-agenten bruke denne MCP-en som et verktøy med tilgang til alle dens funksjoner og muligheter. Husk å endre “hyprmcp” til det faktiske navnet på din MCP-server og bytt ut URL-en med din egen server-URL.

Oversikt

Vår mening

Hyprmcp gir en fokusert og nyttig bro mellom Hyprland og MCP-klienter, med tydelige verktøy og oppsett for minst én hovedplattform. Likevel mangler det prompt-maler, eksplisitte ressursdefinisjoner og bredere oppsett-/plattformstøtte. Som et eksperimentelt prosjekt er det et solid utgangspunkt for avanserte brukere og utviklere, men hadde hatt nytte av utvidet dokumentasjon og ressursstøtte.

MCP-score

RATING: 5/10
Solid på det grunnleggende (verktøy, lisens, kjernefunksjon), men mangler dokumentasjon for prompt/ressurser og detaljer om oppsett på flere plattformer.