Intégration du serveur MCP Hyprmcp

Que fait le serveur MCP “Hyprmcp” ?

Hyprmcp est un serveur léger et non-officiel Model Context Protocol (MCP) qui expose l’ensemble des fonctionnalités de hyprctl, l’interface en ligne de commande du compositeur Wayland Hyprland, aux modèles linguistiques. En s’intégrant avec Hyprmcp, les assistants IA peuvent interroger et contrôler la gestion des fenêtres, des layouts, des entrées et bien plus de Hyprland, en langage naturel. Cela améliore les flux de travail des développeurs et utilisateurs en permettant, par exemple, la récupération d’informations sur les espaces de travail, la gestion des moniteurs, l’exécution de commandes Hyprland arbitraires et l’obtention de l’état système – le tout via une interface conversationnelle IA. Le serveur est conçu pour être expérimental et en bêta, servant de passerelle entre la richesse des commandes Hyprland et les interfaces modernes pilotées par modèle linguistique.

Liste des prompts

Aucun modèle de prompt n’est mentionné dans la documentation disponible ou dans les fichiers du dépôt.

Liste des ressources

Aucune ressource MCP explicite n’est documentée dans le dépôt ou le README.

Liste des outils

• run_hyprctl_command
  Exécute des commandes hyprctl arbitraires.
• get_version
  Récupère la version Hyprland et les informations de build.
• list_monitors
  Liste tous les moniteurs connectés et leurs propriétés.
• list_workspaces
  Liste tous les espaces de travail actifs.
• list_clients
  (Aucune description fournie, mais probablement liste les clients/fenêtres Hyprland.)

Cas d’usage de ce serveur MCP

• Gestion des fenêtres via l’IA
  Permet aux assistants IA de contrôler et d’interroger les fenêtres, layouts et espaces de travail de Hyprland, facilitant l’organisation du bureau.
• Requêtes automatisées d’état système
  Les développeurs peuvent utiliser le langage naturel pour vérifier la configuration des moniteurs, les espaces de travail actifs et les fenêtres clientes, facilitant les diagnostics et le scripting.
• Audit de version et d’environnement
  Récupérez les informations de version/build de Hyprland pour le dépannage ou la documentation via des requêtes IA.
• Intégration avec des outils de développement
  Intégration transparente du contrôle Hyprland dans des clients compatibles MCP (par exemple, Claude, Cursor) pour l’automatisation des développeurs.
• Automatisation de workflows personnalisés
  Utilisez des commandes hyprctl arbitraires via des interfaces conversationnelles pour des configurations avancées et répétables.

Comment le configurer

Windsurf

Aucune instruction d’installation ou exemple de configuration n’est fourni pour Windsurf.

Claude

1. Cloner le dépôt
   • git clone https://github.com/stefanoamorelli/hyprmcp.git
   • cd hyprmcp
2. Récupérer votre HYPRLAND_INSTANCE_SIGNATURE
   • echo $HYPRLAND_INSTANCE_SIGNATURE
3. Éditer la configuration
   • Ouvrez ~/.config/Claude/claude_desktop_config.json
4. Ajouter le serveur MCP Hyprmcp
   • Insérez l’extrait JSON suivant :

     "Hyperland MCP Server": {
       "command": "uv",
       "args": [
         "run",
         "--with",
         "mcp[cli]",
         "--with",
         "subprocess",
         "mcp",
         "run",
         "<chemin global du dépôt>/hyprmcp/hyprmcp/server.py"
       ],
       "env": {
         "PYTHONPATH": "<chemin global du dépôt>/hyprmcp",
         "HYPRLAND_INSTANCE_SIGNATURE": "<votre-hyprland-instance-signature>"
       }
     }
     

5. Enregistrer et redémarrer
   • Enregistrez le fichier et redémarrez Claude Desktop pour appliquer les changements.

Sécurisation des clés API

Utilisez des variables d’environnement dans la section env :

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

Cursor

Aucune instruction d’installation ou exemple de configuration n’est fourni pour Cursor.

Cline

Aucune instruction d’installation ou exemple de configuration n’est fourni pour Cline.

Comment utiliser ce MCP dans les flows

Utilisation du MCP dans FlowHunt

Pour intégrer des serveurs MCP dans votre workflow FlowHunt, commencez par ajouter le composant MCP à votre flow et connectez-le à votre agent IA :

Cliquez sur le composant MCP pour ouvrir le panneau de configuration. Dans la section de configuration système MCP, insérez les détails de votre serveur MCP au format JSON suivant :

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

Une fois configuré, l’agent IA pourra utiliser ce MCP comme outil, avec accès à toutes ses fonctions et capacités. Pensez à remplacer “hyprmcp” par le nom réel de votre serveur MCP et l’URL par celle de votre serveur.

Vue d’ensemble

Notre avis

Hyprmcp offre un pont ciblé et utile entre Hyprland et les clients MCP, avec des outils clairs et une configuration pour au moins une plateforme majeure. Cependant, il manque de modèles de prompt, de définitions de ressources explicites et d’un support d’installation plus large. En tant que projet expérimental, c’est un bon point de départ pour les utilisateurs avancés et les développeurs, mais il bénéficierait d’une documentation et d’un support de ressources élargis.

Score MCP

NOTE : 5/10
Solide sur les bases (outils, licence, fonction principale), mais manque de documentation sur les prompts/ressources et de détails d’installation multi-plateforme.