Assistant IA, haplo-dialog

Développer avec une IA qui connaît gtk3sermo

Si vous écrivez vos scripts avec l'aide d'un assistant IA (Claude ou un autre), vous pouvez lui donner une connaissance précise et à jour de la syntaxe XML de gtk3sermo grâce à un petit compagnon : le serveur gtk3sermo-mcp. Votre assistant sait alors quels widgets existent, quels attributs ils acceptent, et peut vous aider à écrire des dialogues corrects, sans inventer de balises.

Portée : le compagnon décrit la syntaxe de gtk3sermo. Le langage XML étant le même pour gtk4sermo, l'essentiel s'y applique — mais les widgets propres à GTK 4 ou à Qt 6, et les écarts de comportement entre les trois ports ne sont pas encore indexés. Pour ceux-là, la référence de gtk4sermo fait foi.

C'est un outil optionnel : gtk3sermo fonctionne parfaitement sans. Installez-le seulement si vous en avez l'usage.

Conçu pour vous protéger.

Strictement local : il parle à votre assistant par l'entrée/sortie standard. Aucun port ouvert, aucun accès réseau, rien ne quitte votre machine.
Lecture seule : il n'exécute rien, n'écrit rien, ne publie rien.
Contenu embarqué : la documentation qu'il sert est incluse dans le dépôt, dérivée de la documentation publique du projet.

Installer

Il faut Python 3 (aucune autre dépendance). Clonez le dépôt, puis déclarez le serveur dans la configuration MCP de votre assistant. Par exemple, dans un fichier .mcp.json :

git clone https://gitlab.com/haplo-dialog/sermo-mcp.git

{
  "mcpServers": {
    "gtk3sermo": {
      "command": "python3",
      "args": ["/chemin/vers/gtk3sermo-mcp/server.py"]
    }
  }
}

Redémarrez votre assistant : il dispose alors des outils de documentation.

S'en servir

Une fois branché, demandez simplement à votre assistant ce que vous cherchez à faire (« construis-moi un formulaire avec deux champs et un bouton OK », « quels attributs accepte <entry> ? »). Il consultera la documentation via ces outils :

Outil	Ce qu'il donne
`gtk3sermo_reference`	La référence complète de la syntaxe XML.
`gtk3sermo_guide`	Le guide de prise en main.
`gtk3sermo_search`	Recherche dans la documentation.
`gtk3sermo_example`	Un exemple complet de dialogue.
`gtk3sermo_how_to_report`	Comment signaler un bug ou une idée.

Signaler un bug, proposer une idée

gtk3sermo est stable, mais rien n'est parfait. Si vous rencontrez un bug ou avez une idée d'amélioration, ouvrez une issue sur le dépôt GitLab du projet — le suivi des tickets demande un compte GitLab ; sans compte, écrivez à devel@haplo-dialog.fr. Indiquez la version (gtk3sermo --version), un script XML minimal qui reproduit le cas, et le comportement attendu face à celui observé. Ces retours sont lus et pris en compte.