субагент

mcp-server-architect — субагент для Claude Code: серверы MCP под ключ

Q: Как установить mcp-server-architect в Claude Code?

Выполните `npx claude-code-templates@latest --agent mcp-dev-team/mcp-server-architect`, затем проверьте, что появился файл `.claude/agents/mcp-server-architect.md`.

Q: Какие инструменты доступны субагенту?

`Read`, `Write`, `Edit` и `Bash`. Этого хватает, чтобы создавать файлы сервера и запускать сборку или тесты прямо в ходе работы.

Помогает спроектировать и написать MCP-сервер: инструменты, транспорты, сессии, безопасность. Пригодится, когда нужен рабочий сервер, а не набросок.

Установить в Claude Code · Через claude-code-templates Все способы и платформы ↓

npx claude-code-templates@latest --agent mcp-dev-team/mcp-server-architect

Открыть на GitHub

Что делает mcp-server-architect

Субагент ведёт сервер MCP от проектирования до развёртывания. Он разбирает задачу и предметную область, предлагает интерфейсы инструментов с валидацией по JSON Schema, аннотациями (read-only, destructive, idempotent, open-world) и подсказками значений через completion/complete. Дальше — реализация транспортов: JSON-RPC 2.0 поверх stdio и Streamable HTTP, с откатом на SSE для старых клиентов.

Внутри — набор правил разработки. Код пишется на TypeScript с @modelcontextprotocol/sdk (версии 1.10.0 и выше) или на Python с подсказками типов. Отдельно проговариваются сессии с непредсказуемыми идентификаторами, привязанными к пользователю, проверка заголовка Origin на HTTP-запросах, кэширование, пулы соединений и многорегиональное развёртывание. Логи выводятся в stderr, иначе ломается протокол.

У субагента есть доступ к Read, Write, Edit и Bash — он сам правит файлы и запускает команды. Заявлена поддержка спецификации MCP от 2025-06-18; если ваш проект держится на более старой версии протокола, часть рекомендаций придётся отбросить вручную. Без понимания, как устроен JSON-RPC и жизненный цикл сессии, результат будет трудно отлаживать.

Какие задачи решает

спроектировать набор инструментов MCP-сервера с валидацией входных данных
поднять оба транспорта — stdio и Streamable HTTP — в одном сервере
добавить подсказки значений аргументов через completion/complete
закрыть сессии и проверку Origin без утечки идентификаторов клиенту
разнести логи и протокольный вывод по разным потокам

Примеры запросов агенту

Спроектируй MCP-сервер для работы с нашей внутренней базой знаний: инструменты, ресурсы, промпты
Добавь в сервер поддержку completion/complete для аргументов инструмента поиска
Проверь, что сервер корректно отдаёт ошибки и не пишет логи в stdout

Как установить mcp-server-architect

1Через claude-code-templates

npx claude-code-templates@latest --agent mcp-dev-team/mcp-server-architect

2Вручную: положить файлы

.claude/agents/mcp-server-architect.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

Вручную: положить файлы

.codex/agents/mcp-server-architect.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

Вручную: положить файлы

.cursor/agents/mcp-server-architect.md

Cursor понимает и .claude/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о mcp-server-architect

Как установить mcp-server-architect в Claude Code?

Выполните npx claude-code-templates@latest --agent mcp-dev-team/mcp-server-architect, затем проверьте, что появился файл .claude/agents/mcp-server-architect.md.

Что делает mcp-server-architect?

Это субагент-архитектор серверов MCP. Он проектирует инструменты и ресурсы, пишет транспорты, настраивает сессии и следит за соответствием спецификации.

Какие инструменты доступны субагенту?

Read, Write, Edit и Bash. Этого хватает, чтобы создавать файлы сервера и запускать сборку или тесты прямо в ходе работы.

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →

mcp-copilot-studio-server-generator официальный github Генерирует MCP-сервер и файлы Power Platform для интеграции с Copilot Studio. Нужен при создании custom connector со streamable HTTP. 8 700установок basebalance.cloud — x402 RPC & MCP gateway Conway-Research Платный JSON-RPC к сети Base через MCP: бесплатно 10 запросов в минуту, дальше $0.50 за 10 тысяч. С фейловером, кешем и леджером. CX Codex +1 ★ 7 548звёзд репо frontend-developer VoltAgent Community Субагент для разработки полных фронтенд-приложений на React 18+, Vue 3+ и Angular 15+. Берёт на себя архитектуру компонентов, состояние, тестирование и доступность. 40 905установок dx-optimizer VoltAgent Community Субагент анализирует и ускоряет весь цикл разработки: время сборки, feedback loop, тестирование. Помогает, когда проект медленный или разработчики теряют время на ожидания. 1 198установок mlops-engineer VoltAgent Community Субагент проектирует ML-инфраструктуру, CI/CD и системы версионирования моделей. Подойдёт для автоматизации обучения, GPU-ресурсов и мониторинга. 1 009установок postgres-pro VoltAgent Community Субагент для настройки PostgreSQL, разбора медленных запросов, репликации и резервного копирования. Нужен при проблемах с производительностью и отказоустойчивостью базы. 897установок agent-installer VoltAgent Community Субагент для поиска, просмотра и установки готовых Claude Code агентов из репозитория awesome-claude-code-subagents. Упрощает открытие новых инструментов и интеграцию их в проект. 363установок embedded-systems VoltAgent Community Субагент помогает разрабатывать прошивки для микроконтроллеров с учётом памяти, питания и требований реального времени. Нужен для задач с RTOS, драйверами и периферией. 279установок

Из того же набора361

Весь набор →

finish Автоматизирует закрытие веток Git Flow в репозитории: запускает тесты, выполняет слияние и расставляет теги версий. 1 712установок monitoring-specialist Субагент помогает проектировать сбор метрик, логирование, трассировку и оповещения. Подключайте его, когда настраиваете наблюдаемость или SLA-мониторинг. 1 677установок research-coordinator Субагент разбивает сложный исследовательский запрос на задачи для профильных исследователей и задаёт план их совместной работы. Пригодится, когда одного направления поиска недостаточно. 1 673установок release Автоматизирует подготовку релизной ветки по Git Flow. Проверяет семантическую версию, обновляет package.json, собирает список изменений и пушит ветку в origin. 1 664установок hotfix Создаёт ветку Git Flow hotfix от main для срочных исправлений в продакшене. Перед стартом проверяет имя ветки и чистоту рабочей директории. 1 611установок game-designer Помогает проектировать механики, настраивать баланс игровой экономики и рассчитывать кривые сложности. Субагент оформляет дизайн-документы прямо в репозитории проекта. 1 598установок project-supervisor-orchestrator Субагент, который ведёт цепочку других агентов по шагам и возвращает результат в JSON. Пригодится, когда один запрос должен пройти через несколько специализированных агентов. 1 563установок competitive-intelligence-analyst Субагент для Claude, который собирает данные о конкурентах и рынке: профили компаний, SWOT, отраслевые тренды. Пригодится перед запуском продукта или при подготовке стратегии. 1 561установок