Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

Import konfiguracji klienta MCP — trzy serwery używane przez asystenta programowania

Plik .mcp.json Claude Code wymieniający trzy serwery Model Context Protocol — dwa uruchamiane z wiersza poleceń i jeden prowadzony przez kogoś innego — przekształcony przez aggrega import w szkice plików Aggrega, z każdym serwerem przypisanym do realizacji odpowiadającej sposobowi jego działania, i skompilowany dla Kubernetes.

Import konfiguracji klienta MCP omawia to krok po kroku: polecenie, pliki, które zapisuje, i powód każdego wiersza, kompilację oraz działające serwery. Ten folder zawiera każdy etap tego przewodnika:

folder lub plikzawartość
source/konfiguracja klienta, .mcp.json, .aggrega-config.yaml, który czyni folder obszarem roboczym, oraz import-answers.yaml, nazwa obiektu Secret Kubernetes, z którego odczytywany jest token serwera GitHub
draft/pliki zapisane przez aggrega import .mcp.json --target helm, bez zmian, łącznie z release.lock, oraz to, co polecenie wypisało: stdout.txt na standardowe wyjście, import.txt na standardowe wyjście błędów

W kopii repozytorium dokumentacji check.sh ponownie uruchamia import, porównuje to, co zapisuje i wypisuje, z draft/, porównuje bloki cytowane w przewodniku z tymi plikami oraz waliduje i kompiluje to, co zapisał import. Wymaga katalogu biblioteki standardowej (skąd go pobrać) pobranego obok tego repozytorium albo jego folderu wskazanego w AGGREGA_CATALOG_DIRS.

Generowanie przykładu

Import tego przykładu można uruchomić poleceniami poniżej albo zlecić jego uruchomienie swojemu asystentowi AI.

Należy zapisać przykład w nowym folderze nazwanym tak jak on:

Terminal window
aggrega scaffold --example import-mcp

Następnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:

Terminal window
cd import-mcp

Kompilacja

Import tworzy szkice plików Aggrega obok projektu, w source/. Porównuje projekt z katalogiem biblioteki standardowej, który domyślny rejestr obszaru roboczego publikuje jako podpisaną migawkę: pierwszy import pobiera go, weryfikuje, przechowuje w pamięci podręcznej treści obszaru roboczego i wskazuje go przez jego skrót w zapisie, który tworzy obok szkiców. Obszar roboczy, który wskazuje własne foldery katalogu — w AGGREGA_CATALOG_DIRS lub pod workspace.catalog_dirs — importuje zamiast tego względem nich. Import odczytuje nazwę obiektu Secret z import-answers.yaml, a następnie pobiera to, od czego zależy szkic encji Release, więc kompilacja może nastąpić od razu:

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

Kompilacja zapisuje manifesty Kubernetes w dist/helm/; utworzenie obiektu Secret i zastosowanie manifestów opisano w przewodniku podlinkowanym powyżej.

Z asystentem AI

Asystent AI skonfigurowany z narzędziami Aggrega może zrobić to samo: wystarczy wkleić mu ten prompt.

Używaj wyłącznie narzędzi Aggrega i nie twórz samodzielnie żadnego folderu. Jeśli folder obszaru roboczego nie zawiera jeszcze folderu `import-mcp`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `import-mcp` i bez `dir`: zapisze ono przykład w nowym folderze `import-mcp`, którego folder `source` zawiera to, co importuje ten przykład. Następnie wywołaj narzędzie `import` z `workspace_root` ustawionym na `import-mcp/source`, `source` ustawionym na `.mcp.json` i `target` ustawionym na `helm`: odczytuje ono potrzebne odpowiedzi z `import-answers.yaml` obok `.mcp.json`, zapisuje swoje szkice w `import-mcp/source` i pobiera to, czego one potrzebują. Następnie wywołaj narzędzie `validate` z `workspace_root` ustawionym na `import-mcp/source` i `release` ustawionym na `release.yaml` oraz narzędzie `build` z `workspace_root` ustawionym na `import-mcp/source`, `release` ustawionym na `release.yaml` i `write` ustawionym na true. Powiedz mi, które pliki zapisała kompilacja; znajdują się w `import-mcp/source/dist/`.

Testowanie

Po zastosowaniu kompilacji należy przekierować lokalny port do Service serwera fetch i pozostawić polecenie uruchomione:

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

W innym terminalu należy poprosić serwer o otwarcie sesji żądaniem initialize protokołu 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"}}}

Przewodnik wykonuje to samo wywołanie w Docker Compose oraz do serwera GitHub.