Hyprmcp MCP Server-integratie

Wat doet de “Hyprmcp” MCP Server?

Hyprmcp is een lichtgewicht, niet-officiële Model Context Protocol (MCP) server die de volledige functionaliteit van hyprctl, de commandoregelinterface voor de Hyprland Wayland-compositor, beschikbaar maakt voor taalmodellen. Door integratie met Hyprmcp kunnen AI-assistenten Hyprland’s vensterbeheer, indelingen, invoer en meer opvragen en aansturen met natuurlijke taal. Dit verbetert ontwikkelaars- en gebruikersworkflows door taken als het ophalen van werkruimte-informatie, monitorbeheer, uitvoeren van willekeurige Hyprland-commando’s en ophalen van systeemstatus mogelijk te maken—allemaal via een conversatie-AI-interface. De server is bedoeld als experimenteel en bevindt zich in bèta, en vormt een brug tussen Hyprland’s uitgebreide commando’s en moderne, op taalmodellen gebaseerde interfaces.

Lijst van Prompts

Er worden geen prompt-sjablonen genoemd in de beschikbare documentatie of repositorybestanden.

Lijst van Resources

Er zijn geen expliciete MCP-resources gedocumenteerd in de repository of README.

Lijst van Tools

• run_hyprctl_command
  Voert willekeurige hyprctl-commando’s uit.
• get_version
  Haalt de Hyprland-versie en build-informatie op.
• list_monitors
  Geeft alle aangesloten monitoren en hun eigenschappen weer.
• list_workspaces
  Geeft alle actieve werkruimtes weer.
• list_clients
  (Geen beschrijving gegeven, maar toont waarschijnlijk Hyprland clients/vensters.)

Gebruikstoepassingen van deze MCP Server

• Vensterbeheer via AI
  Maakt het mogelijk voor AI-assistenten om Hyprland-vensters, indelingen en werkruimtes te beheren en op te vragen, wat zorgt voor efficiëntere desktoporganisatie.
• Geautomatiseerde systeemstatus-opvragingen
  Ontwikkelaars kunnen met natuurlijke taal monitorconfiguraties, actieve werkruimtes en clientvensters controleren, wat helpt bij diagnostiek en scripting.
• Versie- en omgevingsaudit
  Haal Hyprland-versie/build-informatie op voor probleemoplossing of documentatie via AI-vragen.
• Integratie met ontwikkeltools
  Integreer Hyprland-besturing naadloos in MCP-compatibele clients (zoals Claude, Cursor) voor ontwikkelaarsautomatisering.
• Aangepaste workflow-automatisering
  Gebruik willekeurige hyprctl-commando’s via conversatie-interfaces voor geavanceerde, herhaalbare installaties en workflows.

Hoe stel je het in

Windsurf

Er zijn geen installatie-instructies of configuratievoorbeelden voor Windsurf.

Claude

1. Clone de repository
   • git clone https://github.com/stefanoamorelli/hyprmcp.git
   • cd hyprmcp
2. Haal je HYPRLAND_INSTANCE_SIGNATURE op
   • echo $HYPRLAND_INSTANCE_SIGNATURE
3. Bewerk de configuratie
   • Open ~/.config/Claude/claude_desktop_config.json
4. Voeg Hyprmcp MCP Server toe
   • Voeg het volgende JSON-fragment toe:

     "Hyperland MCP Server": {
       "command": "uv",
       "args": [
         "run",
         "--with",
         "mcp[cli]",
         "--with",
         "subprocess",
         "mcp",
         "run",
         "<globaal pad van de repo>/hyprmcp/hyprmcp/server.py"
       ],
       "env": {
         "PYTHONPATH": "<globaal pad van de repo>/hyprmcp",
         "HYPRLAND_INSTANCE_SIGNATURE": "<jouw-hyprland-instance-signature>"
       }
     }
     

5. Opslaan en herstarten
   • Sla het bestand op en herstart Claude Desktop om de wijzigingen toe te passen.

API-sleutels beveiligen

Gebruik omgevingsvariabelen in de env-sectie:

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

Cursor

Er zijn geen installatie-instructies of configuratievoorbeelden voor Cursor.

Cline

Er zijn geen installatie-instructies of configuratievoorbeelden voor Cline.

Hoe gebruik je deze MCP in flows

MCP gebruiken in FlowHunt

Om MCP-servers te integreren in je FlowHunt-workflow, voeg je het MCP-component toe aan je flow en verbind je deze met je AI-agent:

Klik op het MCP-component om het configuratievenster te openen. Voeg in de systeem-MCP-configuratie je MCP-servergegevens toe in dit JSON-formaat:

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

Na configuratie kan de AI-agent deze MCP nu gebruiken als tool met toegang tot alle functies en mogelijkheden. Vergeet niet “hyprmcp” te vervangen door de daadwerkelijke naam van je MCP-server en de URL door je eigen server-URL.

Overzicht

Onze mening

Hyprmcp biedt een gerichte, bruikbare brug tussen Hyprland en MCP-clients, met duidelijke tools en installatie voor ten minste één groot platform. Het ontbreekt echter aan prompt-sjablonen, expliciete resource-definities en bredere installatie-/platformondersteuning. Als experimenteel project is het een solide startpunt voor power users en ontwikkelaars, maar uitgebreidere documentatie en resource-ondersteuning zouden welkom zijn.

MCP-score

SCORE: 5/10
Sterk in de basis (tools, licentie, kernfunctie), maar mist prompt-/resourcedocumentatie en multi-platform installatie.