Hyprmcp MCP-palvelimen integrointi

Mitä “Hyprmcp” MCP-palvelin tekee?

Hyprmcp on kevyt, epävirallinen Model Context Protocol (MCP) -palvelin, joka altistaa Hyprland Wayland -komposiittorin komentorivikäyttöliittymän hyprctl:n koko toiminnallisuuden kielimalleille. Integroimalla Hyprmcp:n kanssa tekoälyavustajat voivat kysellä ja ohjata Hyprlandin ikkunoiden hallintaa, asetteluja, syötteitä ja muuta luonnollisella kielellä. Tämä tehostaa kehittäjien ja käyttäjien työnkulkuja mahdollistaen esimerkiksi työtilatietojen hakemisen, näyttöjen hallinnan, mielivaltaisten Hyprland-komentojen suorittamisen ja järjestelmän tilan saamisen—kaikki keskustelullisen tekoälykäyttöliittymän kautta. Palvelin on suunniteltu kokeelliseksi ja beetavaiheeseen, tarjoten sillan Hyprlandin laajan komentovalikoiman ja modernien kielimallipohjaisten käyttöliittymien välille.

Prompttipohjat

Saatavilla olevasta dokumentaatiosta tai repositorion tiedostoista ei mainita prompttipohjia.

Resurssilistaus

Repositoriossa tai README:ssä ei ole dokumentoitu eksplisiittisiä MCP-resursseja.

Työkalut

• run_hyprctl_command
  Suorittaa mielivaltaisia hyprctl-komentoja.
• get_version
  Hakee Hyprlandin version ja rakennustiedot.
• list_monitors
  Listaa kaikki liitetyt näytöt ja niiden ominaisuudet.
• list_workspaces
  Listaa kaikki aktiiviset työtilat.
• list_clients
  (Kuvausta ei annettu, mutta todennäköisesti listaa Hyprlandin asiakkaat/ikkunat.)

Tämän MCP-palvelimen käyttötapaukset

• Ikkunoiden hallinta tekoälyllä
  Mahdollistaa tekoälyavustajien ohjata ja kysellä Hyprlandin ikkunoita, asetteluja ja työtiloja, virtaviivaistaen työpöydän järjestelytehtäviä.
• Automatisoidut järjestelmätilakyselyt
  Kehittäjät voivat luonnollisella kielellä tarkistaa näyttöjen määritykset, aktiiviset työtilat ja asiakasikkunat, tukien diagnostiikkaa ja skriptien tekoa.
• Version ja ympäristön auditointi
  Hae Hyprlandin versio-/rakennustiedot vianmääritykseen tai dokumentointiin tekoälykyselyjen kautta.
• Integrointi kehittäjätyökaluihin
  Integroi Hyprlandin ohjaus MCP-yhteensopiviin asiakkaisiin (esim. Claude, Cursor) kehittäjäautomaatiota varten.
• Mukautettu työnkulkuautomaatio
  Käytä mielivaltaisia hyprctl-komentoja keskustelukäyttöliittymien kautta edistyneisiin, toistettaviin asetuksiin ja työnkulkuihin.

Kuinka asennus tehdään

Windsurf

Windsurfin asennusohjeita tai konfiguraatioesimerkkejä ei ole saatavilla.

Claude

1. Kloonaa repositorio
   • git clone https://github.com/stefanoamorelli/hyprmcp.git
   • cd hyprmcp
2. Hanki HYPRLAND_INSTANCE_SIGNATURE
   • echo $HYPRLAND_INSTANCE_SIGNATURE
3. Muokkaa asetuksia
   • Avaa ~/.config/Claude/claude_desktop_config.json
4. Lisää Hyprmcp MCP-palvelin
   • Lisää seuraava JSON-pätkä:

     "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. Tallenna ja käynnistä uudelleen
   • Tallenna tiedosto ja käynnistä Claude Desktop uudelleen, jotta muutokset tulevat voimaan.

API-avaimien suojaaminen

Käytä ympäristömuuttujia env-osiossa:

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

Cursor

Cursorin asennusohjeita tai konfiguraatioesimerkkejä ei ole saatavilla.

Cline

Clinen asennusohjeita tai konfiguraatioesimerkkejä ei ole saatavilla.

Kuinka käyttää tätä MCP:tä Flowsissa

MCP:n käyttö FlowHuntissa

Jotta voit integroida MCP-palvelimet FlowHuntin työnkulkuun, lisää ensin MCP-komponentti työnkulkuun ja yhdistä se tekoälyagenttiin:

Napsauta MCP-komponenttia avataksesi konfiguraatiopaneelin. Järjestelmän MCP-konfiguraatio-osioon lisää MCP-palvelimesi tiedot seuraavassa JSON-muodossa:

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

Kun asetukset on tehty, tekoälyagentti voi nyt käyttää tätä MCP:tä työkaluna, jolla on pääsy kaikkiin sen toimintoihin ja ominaisuuksiin. Muista muuttaa “hyprmcp” MCP-palvelimesi oikeaksi nimeksi ja korvata URL omalla palvelinosoitteellasi.

Yhteenveto

Mielipiteemme

Hyprmcp tarjoaa keskittyneen ja hyödyllisen sillan Hyprlandin ja MCP-asiakkaiden välille, selkeillä työkaluilla ja asennuksella ainakin yhdelle pääalustalle. Se kuitenkin puuttuu prompttipohjia, eksplisiittisiä resurssimäärittelyjä ja laajempaa asennus-/alustatukea. Kokeellisena projektina se on hyvä lähtökohta edistyneille käyttäjille ja kehittäjille, mutta hyötyisi laajennetusta dokumentaatiosta ja resurssituesta.

MCP-arvosana

ARVOSANA: 5/10
Perusasiat kunnossa (työkalut, lisenssi, ydintoiminnot), mutta puutteita promptti-/resurssidokumentaatiossa ja monialustaisissa asennusohjeissa.