Перейти к содержимому
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.