Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Importer une configuration de client MCP — trois serveurs qu’utilise un assistant de programmation

Un .mcp.json de Claude Code listant trois serveurs Model Context Protocol — deux démarrés depuis une ligne de commande et un exploité par quelqu’un d’autre — transformé en brouillons de fichiers Aggrega par aggrega import, chaque serveur étant associé à la réalisation de sa manière de s’exécuter, et compilé pour Kubernetes.

Importer une configuration de client MCP le présente pas à pas : la commande, les fichiers qu’elle écrit et la raison d’être de chaque ligne, la compilation et les serveurs en cours d’exécution. Ce dossier contient chaque étape de ce tutoriel :

dossier ou fichierce qu’il contient
source/la configuration du client, .mcp.json, le .aggrega-config.yaml qui fait du dossier un espace de travail, et import-answers.yaml, le nom du Secret Kubernetes depuis lequel le jeton du serveur GitHub est lu
draft/les fichiers que aggrega import .mcp.json --target helm a écrits, inchangés, release.lock compris, et ce qu’il a affiché : stdout.txt sur la sortie standard, import.txt sur la sortie d’erreur standard

Dans un checkout du dépôt de la documentation, check.sh exécute à nouveau l’import, compare ce qu’il écrit et affiche avec draft/, compare les blocs que le tutoriel cite avec ces fichiers, et valide et compile ce que l’import a écrit. Il nécessite le catalogue de la bibliothèque standard (où en obtenir un) extrait à côté de ce dépôt, ou son répertoire indiqué dans AGGREGA_CATALOG_DIRS.

Générer l’exemple

Vous pouvez exécuter l’import de cet exemple avec les commandes ci-dessous, ou le faire exécuter par votre assistant IA.

Écrivez l’exemple dans un nouveau dossier qui porte son nom :

Terminal window
aggrega scaffold --example import-mcp

Elle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :

Terminal window
cd import-mcp

Build

L’import rédige les brouillons des fichiers Aggrega à côté du projet, dans source/. Il évalue le projet par rapport au catalogue de la bibliothèque standard, que le registre par défaut de l’espace de travail publie sous forme d’instantané signé : le premier import le récupère, le vérifie, le conserve dans le cache de contenu de l’espace de travail et le désigne par son condensé dans l’enregistrement qu’il écrit à côté des brouillons. Un espace de travail qui désigne ses propres dossiers de catalogue — dans AGGREGA_CATALOG_DIRS, ou sous workspace.catalog_dirs — importe plutôt par rapport à ceux-ci. L’import lit le nom du Secret dans import-answers.yaml, puis récupère ce dont dépend la Release rédigée, de sorte que la compilation suit aussitôt :

Terminal window
cd source
aggrega import .mcp.json --target helm
aggrega build --release release.yaml

La compilation écrit les manifestes Kubernetes sous dist/helm/ ; la création du Secret et leur application sont décrites dans le tutoriel lié ci-dessus.

Avec un assistant IA

Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.

Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier de l’espace de travail ne contient pas encore de dossier `import-mcp`, appelez une fois l’outil `scaffold` avec `example` défini à `import-mcp` et sans `dir` : il écrit l’exemple dans un nouveau dossier `import-mcp`, dont le dossier `source` contient ce que cet exemple importe. Appelez ensuite l’outil `import` avec `workspace_root` défini à `import-mcp/source`, `source` défini à `.mcp.json` et `target` défini à `helm` : il lit les réponses dont il a besoin dans `import-answers.yaml`, à côté de `.mcp.json`, écrit ses brouillons dans `import-mcp/source` et récupère ce dont ils ont besoin. Appelez ensuite l’outil `validate` avec `workspace_root` défini à `import-mcp/source` et `release` défini à `release.yaml`, puis l’outil `build` avec `workspace_root` défini à `import-mcp/source`, `release` défini à `release.yaml` et `write` défini à true. Indiquez-moi quels fichiers le build a écrits ; ils se trouvent sous `import-mcp/source/dist/`.

Tester

Une fois le build appliqué, redirigez un port local vers le Service du serveur fetch et laissez la commande s’exécuter :

Terminal window
kubectl port-forward svc/fetch-default 8080:8080

Depuis un autre terminal, demandez au serveur d’ouvrir une session avec la requête initialize de MCP :

Terminal window
curl -sS http://127.0.0.1:8080/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "test-it", "version": "1.0.0"}}}'
: keepalive
: keepalive
event: message
data: {"jsonrpc":"2.0","id":1,"result":{"capabilities":{"prompts":{"listChanged":false},"resources":{"listChanged":false,"subscribe":false},"tools":{"listChanged":false}},"protocolVersion":"2025-06-18","serverInfo":{"name":"mcp-fetch","version":"2026.11.11"}}}

Le guide effectue le même appel sur Docker Compose et vers le serveur GitHub.