Eine MCP-Client-Konfiguration importieren — drei Server, die ein Coding-Assistent nutzt
Eine .mcp.json von Claude Code mit drei Model-Context-Protocol-Servern — zwei über eine Befehlszeile gestartet und einer, den jemand anderes betreibt — von aggrega import als Entwurf in Aggrega-Dateien überführt, wobei jeder Server der Realisierung seiner Ausführungsweise zugeordnet wird, und für Kubernetes gebaut.
Eine MCP-Client-Konfiguration importieren führt Schritt für Schritt hindurch: der Befehl, die Dateien, die er schreibt, und warum jede Zeile darin steht, der Build und die laufenden Server. Dieser Ordner enthält jede Stufe dieser Anleitung:
| Ordner oder Datei | was er enthält |
|---|---|
source/ | die Client-Konfiguration, .mcp.json, die .aggrega-config.yaml, die den Ordner zu einem Workspace macht, und import-answers.yaml, der Name des Kubernetes-Secrets, aus dem das Token des GitHub-Servers gelesen wird |
draft/ | die Dateien, die aggrega import .mcp.json --target helm geschrieben hat, unverändert, einschließlich release.lock, und was der Befehl ausgegeben hat: stdout.txt auf der Standardausgabe, import.txt auf der Standardfehlerausgabe |
In einem Checkout des Dokumentations-Repositorys führt check.sh den Import erneut aus, vergleicht, was er schreibt und ausgibt, mit draft/, vergleicht die Blöcke, die die Anleitung zitiert, mit diesen Dateien und validiert und baut, was der Import geschrieben hat. Es benötigt den Katalog der Standardbibliothek (woher Sie einen bekommen), neben diesem Repository ausgecheckt, oder dessen Verzeichnis in AGGREGA_CATALOG_DIRS angegeben.
Das Beispiel generieren
Sie können den Import dieses Beispiels mit den folgenden Befehlen ausführen oder ihn von Ihrem KI-Assistenten für Sie ausführen lassen.
Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:
aggrega scaffold --example import-mcpDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd import-mcpBuild
Der Import erstellt die Aggrega-Dateien als Entwurf neben dem Projekt, in source/. Er gleicht das Projekt mit dem Katalog der Standardbibliothek ab, den die Standard-Registry des Workspace als signierten Snapshot veröffentlicht: Der erste Import lädt ihn herunter, verifiziert ihn, legt ihn im Inhaltscache des Workspace ab und benennt ihn über seinen Digest in dem Datensatz, den er neben die Entwürfe schreibt. Ein Workspace, der eigene Katalogordner angibt — in AGGREGA_CATALOG_DIRS oder unter workspace.catalog_dirs —, importiert stattdessen gegen diese. Der Import liest den Namen des Secrets aus import-answers.yaml und lädt dann herunter, wovon das entworfene Release abhängt, sodass der Build sofort folgen kann:
cd sourceaggrega import .mcp.json --target helmaggrega build --release release.yamlDer Build schreibt die Kubernetes-Manifeste unter dist/helm/; das Anlegen des Secrets und das Anwenden der Manifeste beschreibt die oben verlinkte Anleitung.
Mit einem KI-Assistenten
Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.
Verwenden Sie ausschließlich die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `import-mcp` enthält, rufen Sie das Tool `scaffold` einmal auf, mit `example` auf `import-mcp` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `import-mcp`, dessen Ordner `source` enthält, was dieses Beispiel importiert. Rufen Sie dann das Tool `import` auf, mit `workspace_root` auf `import-mcp/source`, `source` auf `.mcp.json` und `target` auf `helm` gesetzt: Es liest die benötigten Antworten aus `import-answers.yaml` neben `.mcp.json`, schreibt seine Entwürfe nach `import-mcp/source` und lädt herunter, was diese benötigen. Rufen Sie dann das Tool `validate` auf, mit `workspace_root` auf `import-mcp/source` und `release` auf `release.yaml` gesetzt, und das Tool `build`, mit `workspace_root` auf `import-mcp/source`, `release` auf `release.yaml` und `write` auf true gesetzt. Nennen Sie mir die Dateien, die der Build geschrieben hat; sie liegen unter `import-mcp/source/dist/`.Testen
Leiten Sie nach dem Anwenden des Builds einen lokalen Port an den Service des Servers fetch weiter und lassen Sie den Befehl laufen:
kubectl port-forward svc/fetch-default 8080:8080Bitten Sie den Server in einem anderen Terminal, mit der MCP-Anfrage initialize eine Sitzung zu öffnen:
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: messagedata: {"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"}}}Die Anleitung führt denselben Aufruf auf Docker Compose und an den GitHub-Server aus.