Hyprmcp MCP-serverintegration

Vad gör “Hyprmcp” MCP-servern?

Hyprmcp är en lättviktig, inofficiell Model Context Protocol (MCP)-server som exponerar hela funktionaliteten i hyprctl, kommandoradsgränssnittet för Hyprland Wayland-kompositorn, till språkmodeller. Genom att integrera med Hyprmcp kan AI-assistenter hämta och styra Hyprlands fönsterhantering, layouter, inmatningar och mer med naturligt språk. Detta förbättrar arbetsflöden för både utvecklare och användare genom att möjliggöra uppgifter som att hämta arbetsyteinformation, hantera bildskärmar, köra valfria Hyprland-kommandon och inhämta systemstatus – allt via ett konversationellt AI-gränssnitt. Servern är experimentell och i beta, och fungerar som en brygga mellan Hyprlands rika kommandouppsättning och moderna språkmodellsdrivna gränssnitt.

Lista över prompts

Inga prompt-mallar nämns i den tillgängliga dokumentationen eller i repositories.

Lista över resurser

Inga explicita MCP-resurser finns dokumenterade i repository eller README.

Lista över verktyg

• run_hyprctl_command
  Kör valfria hyprctl-kommandon.
• get_version
  Hämtar Hyprland-version och bygginformation.
• list_monitors
  Listar alla anslutna bildskärmar och deras egenskaper.
• list_workspaces
  Listar alla aktiva arbetsytor.
• list_clients
  (Ingen beskrivning angiven, men listar troligen Hyprland-klienter/fönster.)

Användningsfall för denna MCP-server

• Fönsterhantering via AI
  Möjliggör för AI-assistenter att styra och hämta information om Hyprland-fönster, layouter och arbetsytor, vilket förenklar skrivbordsorganisation.
• Automatiserade systemstatusförfrågningar
  Utvecklare kan använda naturligt språk för att kontrollera bildskärmskonfigurationer, aktiva arbetsytor och klientfönster, vilket förenklar diagnostik och skriptning.
• Versions- och miljögranskning
  Hämta Hyprland-version/bygginfo för felsökning eller dokumentation via AI-frågor.
• Integration med utvecklarverktyg
  Integrera Hyprland-kontroll sömlöst i MCP-kompatibla klienter (t.ex. Claude, Cursor) för utvecklarautomation.
• Anpassad arbetsflödesautomation
  Använd valfria hyprctl-kommandon via konversationella gränssnitt för avancerade, upprepbara inställningar och arbetsflöden.

Hur det installeras

Windsurf

Inga installationsinstruktioner eller konfigurationsexempel finns för Windsurf.

Claude

1. Klona repositoryt
   • git clone https://github.com/stefanoamorelli/hyprmcp.git
   • cd hyprmcp
2. Hämta din HYPRLAND_INSTANCE_SIGNATURE
   • echo $HYPRLAND_INSTANCE_SIGNATURE
3. Redigera konfiguration
   • Öppna ~/.config/Claude/claude_desktop_config.json
4. Lägg till Hyprmcp MCP-server
   • Infoga följande 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. Spara och starta om
   • Spara filen och starta om Claude Desktop för att tillämpa ändringarna.

Säkra API-nycklar

Använd miljövariabler i env-sektionen:

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

Cursor

Inga installationsinstruktioner eller konfigurationsexempel finns för Cursor.

Cline

Inga installationsinstruktioner eller konfigurationsexempel finns för Cline.

Hur du använder denna MCP i flows

Använda MCP i FlowHunt

För att integrera MCP-servrar i ditt FlowHunt-arbetsflöde, börja med att lägga till MCP-komponenten i ditt flöde och koppla den till din AI-agent:

Klicka på MCP-komponenten för att öppna konfigurationspanelen. I systemets MCP-konfigurationssektion lägger du in dina MCP-serveruppgifter enligt detta JSON-format:

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

När du har konfigurerat detta kan AI-agenten använda denna MCP som ett verktyg med tillgång till alla dess funktioner och möjligheter. Kom ihåg att ändra “hyprmcp” till din MCP-servers faktiska namn och byt ut URL:en mot din egen serveradress.

Översikt

Vår bedömning

Hyprmcp levererar en fokuserad, användbar brygga mellan Hyprland och MCP-klienter, med tydliga verktyg och installation för åtminstone en större plattform. Dock saknas prompt-mallar, explicita resursdefinitioner och bredare installations-/plattformssupport. Som ett experimentellt projekt är det en solid startpunkt för avancerade användare och utvecklare, men skulle gynnas av utökad dokumentation och resurssupport.

MCP-betyg

BETYG: 5/10
Stabil på grunderna (verktyg, licens, kärnfunktion), men brister i prompt-/resursdokumentation och detaljer om flerplattformssupport.