Hyprmcp MCP-Server-Integration

Was macht der „Hyprmcp“-MCP-Server?

Hyprmcp ist ein schlanker, inoffizieller Model Context Protocol (MCP) Server, der die volle Funktionalität von hyprctl, der Befehlszeilenschnittstelle des Hyprland Wayland-Compositors, für Sprachmodelle bereitstellt. Durch die Integration mit Hyprmcp können KI-Assistenten Hyprlands Fensterverwaltung, Layouts, Eingaben und mehr mit natürlicher Sprache abfragen und steuern. Dies verbessert Entwickler- und Nutzer-Workflows, indem Aufgaben wie das Abrufen von Arbeitsflächen-Informationen, das Verwalten von Monitoren, das Ausführen beliebiger Hyprland-Befehle und das Abrufen des Systemstatus – alles über eine KI-Schnittstelle – ermöglicht werden. Der Server ist experimentell und im Beta-Stadium und schlägt eine Brücke zwischen Hyprlands umfangreichem Befehlssatz und modernen, modellgesteuerten Benutzeroberflächen.

Liste der Prompts

In der verfügbaren Dokumentation oder im Repository sind keine Prompt-Vorlagen genannt.

Liste der Ressourcen

Im Repository oder README sind keine expliziten MCP-Ressourcen dokumentiert.

Liste der Tools

• run_hyprctl_command
  Führt beliebige hyprctl-Befehle aus.
• get_version
  Ruft die Hyprland-Version und Build-Informationen ab.
• list_monitors
  Listet alle verbundenen Monitore und deren Eigenschaften auf.
• list_workspaces
  Listet alle aktiven Arbeitsflächen auf.
• list_clients
  (Keine Beschreibung angegeben, listet vermutlich Hyprland-Clients/Fenster.)

Anwendungsfälle dieses MCP-Servers

• Fensterverwaltung via KI
  Ermöglicht KI-Assistenten die Steuerung und Abfrage von Hyprland-Fenstern, Layouts und Arbeitsflächen und erleichtert so die Desktop-Organisation.
• Automatisierte Systemstatus-Abfragen
  Entwickler können per natürlicher Sprache Monitor-Konfigurationen, aktive Arbeitsflächen und Client-Fenster prüfen – hilfreich für Diagnosen und Scripting.
• Versions- und Umgebungs-Auditing
  Rufen Sie Hyprland-Version/Build-Informationen für Troubleshooting oder Dokumentation per KI-Abfrage ab.
• Integration mit Entwickler-Tools
  Integrieren Sie Hyprland-Steuerung nahtlos in MCP-kompatible Clients (z. B. Claude, Cursor) für Entwickler-Automatisierung.
• Individuelle Workflow-Automatisierung
  Nutzen Sie beliebige hyprctl-Befehle über Konversationsschnittstellen für fortgeschrittene, wiederholbare Setups und Workflows.

Wie richtet man es ein

Windsurf

Für Windsurf sind keine Einrichtungsanweisungen oder Konfigurationsbeispiele vorhanden.

Claude

1. Repository klonen
   • git clone https://github.com/stefanoamorelli/hyprmcp.git
   • cd hyprmcp
2. Ihre HYPRLAND_INSTANCE_SIGNATURE ermitteln
   • echo $HYPRLAND_INSTANCE_SIGNATURE
3. Konfiguration bearbeiten
   • Öffnen Sie ~/.config/Claude/claude_desktop_config.json
4. Hyprmcp MCP-Server hinzufügen
   • Fügen Sie das folgende JSON-Snippet ein:

     "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. Speichern und Neustarten
   • Speichern Sie die Datei und starten Sie Claude Desktop neu, um die Änderungen zu übernehmen.

API-Schlüssel absichern

Verwenden Sie Umgebungsvariablen im env-Abschnitt:

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

Cursor

Für Cursor sind keine Einrichtungsanweisungen oder Konfigurationsbeispiele vorhanden.

Cline

Für Cline sind keine Einrichtungsanweisungen oder Konfigurationsbeispiele vorhanden.

Wie nutze ich diesen MCP in Flows

MCP in FlowHunt verwenden

Um MCP-Server in Ihren FlowHunt-Workflow zu integrieren, fügen Sie zunächst die MCP-Komponente zu Ihrem Flow hinzu und verbinden Sie sie mit Ihrem KI-Agenten:

Klicken Sie auf die MCP-Komponente, um das Konfigurationspanel zu öffnen. Fügen Sie im System-MCP-Konfigurationsbereich Ihre MCP-Serverdaten in diesem JSON-Format ein:

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

Nach der Konfiguration kann der KI-Agent diesen MCP als Tool mit Zugriff auf alle Funktionen und Möglichkeiten nutzen. Denken Sie daran, “hyprmcp” durch den tatsächlichen Namen Ihres MCP-Servers zu ersetzen und die URL entsprechend anzupassen.

Übersicht

Unsere Meinung

Hyprmcp bietet eine fokussierte, nützliche Brücke zwischen Hyprland und MCP-Clients, mit klaren Tools und Einrichtung auf mindestens einer wichtigen Plattform. Allerdings fehlen Prompt-Vorlagen, explizite Ressourcendefinitionen und eine breitere Plattformunterstützung. Als experimentelles Projekt ist es ein solider Ausgangspunkt für Power-User und Entwickler, würde aber von erweiterter Dokumentation und Ressourcenunterstützung profitieren.

MCP-Bewertung

BEWERTUNG: 5/10
Stark in den Grundlagen (Tools, Lizenz, Kernfunktion), aber es mangelt an Prompt-/Ressourcendokumentation und Multi-Plattform-Setup-Details.