38 outils sans dévorer la fenêtre de contexte : comment nous avons conçu le serveur MCP de KwaFlux

L’essentiel

• Chaque outil qu’offre un serveur MCP est décrit au modèle, et cette description occupe du contexte que le modèle pourrait consacrer à votre demande.
• Avec les 38 outils chargés, la liste d’outils de KwaFlux pèse 51 004 octets, sous un budget de 60 000 octets. En ne chargeant que le groupe de base, elle tombe à 7077 octets.
• Les groupes d’outils vous permettent de ne charger que ce dont vous vous servez : définissez KWAFLUX_MCP_TOOLSETS, et les groupes non sélectionnés n’arrivent pas jusqu’au modèle.
• Les budgets sont contrôlés par des tests. Si une modification fait dépasser son budget à la liste d’outils, au groupe de base ou aux instructions du serveur, les tests échouent.

Un serveur MCP qui fait beaucoup de choses a un coût discret : le nom, la description et le schéma d’entrée de chaque outil sont envoyés au modèle pour qu’il sache que l’outil existe. Avec quelques outils, cela ne compte pas. Avec 38, cela peut occuper une part sensible de la fenêtre de contexte avant même que vous ayez tapé quoi que ce soit.

Nous avons conçu le serveur MCP de KwaFlux autour de ce coût. Les schémas sont générés, pas écrits à la main ; les outils sont répartis en groupes que vous pouvez désactiver ; les résultats sont structurés plutôt que bavards ; et les tailles ont des budgets que des tests font respecter.

Dans ce guide, vous verrez d’où vient le coût en contexte d’un serveur MCP, comment KwaFlux le mesure et le limite, comment charger moins d’outils, et les choix de conception qui rendent le suivi des longues tâches vidéo peu coûteux.

Sommaire

1. Combien de contexte coûte un outil MCP ?
2. Les chiffres de KwaFlux
3. Des budgets que les tests font respecter
4. Ne charger que les groupes utiles
5. Des schémas générés à partir de la configuration de l’app
6. Des résultats qu’on n’a pas besoin de lire deux fois
7. Tâches longues : progression et annulation plutôt qu’interrogations répétées
8. Des prompts pour les workflows en plusieurs étapes
9. Questions fréquentes

Combien de contexte coûte un outil MCP ?

Le coût en contexte d’un outil MCP, c’est la taille de sa définition, c’est-à-dire son nom, son titre, sa description et son JSON Schema d’entrées et de sorties, que l’hôte transmet au modèle à chaque requête d’une session.

Les hôtes obtiennent les définitions par une requête tools/list. La plupart les incluent ensuite dans le contexte du modèle pour qu’il puisse choisir un outil. La spécification MCP demande aux serveurs de renvoyer les outils dans un ordre stable, en partie parce que cela « améliore le taux de succès du cache de prompt des LLM lorsque les outils sont inclus dans le contexte du modèle », ce qui montre à quel point il est courant qu’ils s’y retrouvent.

Les chiffres de KwaFlux

La liste complète représente environ 51 Ko de JSON. Le nombre de tokens correspondant dépend du tokenizer du modèle, mais c’est un coût fixe par session, payé avant la première requête. Le groupe de base seul en représente environ un septième.

Des budgets que les tests font respecter

Un objectif de taille dans un document de conception finit par dériver. Un objectif de taille dans un test, non.

Le serveur MCP de KwaFlux dispose d’un script de mesure qui tourne avec ses tests. Il construit la vraie réponse tools/list, la mesure en octets, mesure à part le groupe de base, ainsi que les instructions du serveur en caractères, et échoue si l’une de ces valeurs dépasse son budget.

Cela change la façon d’écrire les outils. Un nouvel outil doit tenir dans le budget : une description trop longue est raccourcie, une explication répétée part dans les instructions communes, et un enum remplace le paragraphe qui détaillait les valeurs valides. Le budget laisse un peu de marge, environ 9 Ko sur la liste complète, pour les fonctions à venir.

Ne charger que les groupes utiles

Les 38 outils de KwaFlux sont répartis en groupes ; le tableau présente les principaux. Le groupe de base est chargé dans toutes les configurations. Vous choisissez les autres avec la variable d’environnement KWAFLUX_MCP_TOOLSETS, et les groupes que vous ne choisissez pas ne sont pas enregistrés du tout : ils ne prennent pas de contexte.

Par exemple, si vous ne vous servez de votre assistant que pour convertir et réparer des fichiers, ajoutez la variable à l’entrée KwaFlux de la configuration MCP de votre hôte :

{
  "mcpServers": {
    "kwaflux": {
      "command": "<path to node>",
      "args": ["<path to kwaflux_mcp.mjs>"],
      "env": { "KWAFLUX_MCP_TOOLSETS": "convert,repair" }
    }
  }
}

Copiez command et args depuis la page Paramètres › Agent (MCP) de KwaFlux plutôt que de les taper ; le guide de démarrage rapide montre où les trouver. Chaque hôte a son propre format de configuration : placez env là où votre hôte l’attend.

Astuce : commencez avec tout chargé le temps de découvrir ce que votre assistant sait faire, puis réduisez aux groupes dont vous vous servez vraiment. Une liste d’outils plus courte rend aussi moins probable que le modèle choisisse un outil que vous ne visiez pas.

Des schémas générés à partir de la configuration de l’app

L’essentiel des octets d’une liste d’outils, ce sont les schémas d’entrée. Les schémas écrits à la main ont tendance à grossir : un champ décrit en prose, des valeurs valides listées dans la description puis à nouveau dans le schéma, des remarques sur les exceptions.

Les schémas d’amélioration de KwaFlux sont générés à partir du même fichier de configuration que les écrans de l’app. Chaque réglage devient un champ typé avec sa vraie plage ou sa vraie liste d’options, si bien que le modèle voit "enum": [...] au lieu d’une phrase sur les valeurs autorisées. Les variantes photo viennent du même fichier. L’article sur le plan de contrôle explique comment un test de divergence maintient les règles générées alignées sur l’app.

Cela garde aussi les outils étroits. Chacun prend les quelques champs qu’une personne choisirait, et KwaFlux construit lui-même le traitement complet. Un outil qui accepterait une description de traitement brute aurait besoin d’un schéma pour tout ce que le moteur sait faire, schéma plus volumineux et plus difficile à vérifier.

Des résultats qu’on n’a pas besoin de lire deux fois

Chaque outil de KwaFlux déclare un outputSchema. D’après la spécification MCP, si un outil en fournit un, « les serveurs doivent (MUST) fournir des résultats structurés conformes à ce schéma », et les clients « devraient (SHOULD) valider les résultats structurés par rapport à ce schéma ».

Pour le contexte, cela veut dire des résultats en JSON compact aux champs prévisibles : un identifiant de tâche, un statut, un nom de fichier de sortie. Le modèle n’a pas à lire un paragraphe pour savoir si quelque chose a fonctionné, et un hôte peut vérifier le résultat sans interroger le modèle. Les résultats laissent aussi de côté ce dont le modèle n’a pas besoin, un point traité dans l’article sur les chemins et la confidentialité.

Tâches longues : progression et annulation plutôt qu’interrogations répétées

Une tâche vidéo peut prendre plusieurs minutes. La manière évidente, pour un assistant, de la suivre consiste à demander « c’est fini ? » encore et encore, et chaque vérification alourdit le contexte.

Le groupe de base de KwaFlux propose à la place un outil d’attente :

• Progression. Quand l’hôte fournit un progressToken, KwaFlux envoie des notifications/progress pendant que la tâche tourne. Les hôtes les affichent sous forme de barre de progression, hors du contexte du modèle.
• Annulation. Si vous arrêtez la requête dans l’hôte, ce qui envoie notifications/cancelled, KwaFlux cesse d’attendre aussitôt. L’assistant peut ensuite annuler la tâche elle-même si vous le souhaitez.

Un seul appel d’attente remplace une boucle de vérifications d’état : un export de dix minutes coûte à peu près le même contexte qu’un export de dix secondes.

Des prompts pour les workflows en plusieurs étapes

Certaines tâches demandent plusieurs outils dans l’ordre : diagnostiquer, puis réparer, puis améliorer, puis exporter. Expliquer cet ordre dans la description de chaque outil coûterait des octets à chaque requête. KwaFlux le fournit plutôt sous forme de quatre prompts MCP :

• réparer une vidéo endommagée
• exporter pour une plateforme
• télécharger, puis convertir
• réparation de qualité par IA

La spécification MCP décrit les prompts comme « contrôlés par l’utilisateur », généralement proposés sous forme de commandes slash. Ils ne coûtent rien tant que vous n’en choisissez pas un, et donnent alors au modèle les étapes de la tâche. L’article sur les capacités montre ce que fait chaque étape.

Conclusion

Traitez la liste d’outils comme un budget, pas comme un catalogue : mesurez-la, plafonnez-la dans un test et laissez chacun ne charger que les groupes dont il a besoin. Gardez ensuite chaque appel peu coûteux, avec des entrées typées générées à partir de la vraie configuration, des résultats structurés et une progression plutôt que des interrogations répétées. C’est ainsi que KwaFlux fait tenir 38 outils dans un seul serveur sans évincer votre demande.

Chargez les outils utiles, laissez le reste

Le serveur MCP local de KwaFlux donne à Codex, Claude, Cursor et aux autres applications MCP jusqu’à 38 outils répartis en groupes que l’on peut désactiver, le groupe de base étant actif dans toutes les configurations. Le traitement IA tourne sur votre propre GPU et vos fichiers média ne sont pas envoyés pour être traités. KwaFlux fonctionne sous Windows 10 (64 bits, version 1809 ou plus récente), Windows 11 et macOS 12 ou plus récent sur Apple Silicon. Importer des fichiers et explorer l’app ne demandent pas de compte. Une connexion avec un forfait payant n’est requise que pour exporter, convertir, réparer un fichier ou télécharger un fichier depuis un lien.

Télécharger KwaFlux · Voir les offres