Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Імпорт конфігурації клієнта MCP — три сервери, якими користується асистент для програмування

Файл .mcp.json для Claude Code зі списком трьох серверів Model Context Protocol — двох, що запускаються з командного рядка, і одного, яким керує хтось інший, — перетворений командою aggrega import на чернетки файлів Aggrega, де кожен сервер зіставлено з реалізацією того, як він працює, і зібраний для Kubernetes.

Імпорт конфігурації клієнта MCP покроково описує цей процес: команду, файли, які вона записує, і навіщо в них кожен рядок, збірку та запущені сервери. У цій теці зберігається кожен етап цього покрокового опису:

тека або файлщо містить
source/конфігурація клієнта .mcp.json, файл .aggrega-config.yaml, який робить теку робочим простором, і import-answers.yaml — ім’я Kubernetes Secret, з якого зчитується токен сервера GitHub
draft/файли, які записала команда aggrega import .mcp.json --target helm, без змін, разом із release.lock, і те, що вона вивела: stdout.txt — стандартний вивід, import.txt — стандартний потік помилок

У клоні репозиторію документації check.sh знову запускає імпорт, порівнює те, що він записує й виводить, із draft/, порівнює блоки, які цитує покроковий опис, із цими файлами, а також перевіряє та збирає те, що записав імпорт. Для цього каталог стандартної бібліотеки (де його взяти) має бути розгорнутий поруч із цим репозиторієм або його директорію має бути вказано в AGGREGA_CATALOG_DIRS.

Створення прикладу

Імпорт цього прикладу можна запустити командами нижче або доручити його запуск своєму ШІ-асистентові.

Запишіть приклад у нову теку, названу за ним:

Terminal window
aggrega scaffold --example import-mcp

Потім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:

Terminal window
cd import-mcp

Збирання

Імпорт створює чернетки файлів Aggrega поруч із проєктом, у source/. Він зіставляє проєкт із каталогом стандартної бібліотеки, який типовий реєстр робочого простору публікує як підписаний знімок: перший імпорт завантажує його, перевіряє, зберігає в кеші вмісту робочого простору та позначає його дайджестом у записі, який пише поруч із чернетками. Робочий простір, що вказує власні теки каталогу — у AGGREGA_CATALOG_DIRS або в workspace.catalog_dirs, — натомість імпортує відносно них. Імпорт зчитує ім’я Secret з import-answers.yaml, а потім завантажує те, від чого залежить чернетка сутності Release, тож збірка може відбутися одразу:

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

Збірка записує маніфести Kubernetes у dist/helm/; створення Secret і застосування маніфестів описано в покроковому описі, посилання на який наведено вище.

З ШІ-асистентом

ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.

Використовуйте лише інструменти Aggrega і не створюйте жодної теки самостійно. Якщо тека робочої області ще не містить теки `import-mcp`, викличте один раз інструмент `scaffold`, задавши для `example` значення `import-mcp` і не вказуючи `dir`: він запише приклад у нову теку `import-mcp`, тека `source` якої містить те, що імпортує цей приклад. Потім викличте інструмент `import`, задавши `workspace_root` значення `import-mcp/source`, `source` — `.mcp.json`, а `target` — `helm`: він читає потрібні йому відповіді з `import-answers.yaml` поруч із `.mcp.json`, записує свої чернетки в `import-mcp/source` і завантажує те, що їм потрібно. Потім викличте інструмент `validate`, задавши `workspace_root` значення `import-mcp/source`, а `release` — `release.yaml`, та інструмент `build`, задавши `workspace_root` значення `import-mcp/source`, `release` — `release.yaml`, а `write` — true. Скажіть мені, які файли записала збірка; вони розташовані в `import-mcp/source/dist/`.

Тестування

Застосувавши збірку, переспрямуйте локальний порт на Service сервера fetch і залиште команду працювати:

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

З іншого термінала попросіть сервер відкрити сеанс запитом MCP initialize:

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"}}}

Посібник робить той самий виклик у Docker Compose і до сервера GitHub.