# mcp-specialist

Субагент mcp-specialist для разработки и настройки MCP-серверов в Claude Code. Помогает спроектировать архитектуру, реализовать транспортный слой, настроить инструменты и ресурсы, отладить подключения по спецификации MCP 2025-06-18.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 328 у репозитория
- Автор: coco-research
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/coco-research/coco/tree/HEAD/agents/mcp-specialist.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/mcp-specialist

## Что делает

mcp-specialist закрывает весь цикл работы с MCP: от выбора архитектуры и дизайна инструментов до production-развёртывания и troubleshooting в Cursor и Claude Code. Субагент знает JSON-RPC 2.0, транспорты (stdio и Streamable HTTP), управление сессиями, валидацию схем через Zod и Pydantic, обработку ошибок по стандартам протокола.

Внутри — шаблоны конфигурации для БД, REST-API, файловой системы; чек-лист разработки с требованиями к security (валидация входов, rate limiting, переменные окружения для secrets), производительности (connection pooling, кэширование), тестированию (>90% покрытия, все транспорты). Помогает интегрировать GitHub, Stripe, AWS, настроить аутентификацию и логирование (только в stderr).

Если строишь свой MCP-сервер на TypeScript или Python, настраиваешь подключение к облачному сервису или отлаживаешь connection-ошибки в IDE — этот субагент даст конкретный путь: от выбора SDK (TypeScript >= 1.10.0) до верификации протокола.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/mcp-specialist.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/mcp-specialist.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/mcp-specialist.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/coco-research/coco/tree/HEAD/agents/mcp-specialist.md

## Когда брать
- спроектировать архитектуру MCP-сервера с правильным транспортным слоем
- реализовать инструменты и ресурсы с валидацией по JSON Schema
- интегрировать базы данных, API и облачные сервисы через MCP
- настроить MCP в `.mcp.json` или `.cursor/mcp.json` для Claude Code и Cursor
- отладить connection-ошибки и проверить protocol compliance

## Примеры запросов агенту
- Помоги спроектировать MCP-сервер для работы с PostgreSQL: какой транспорт выбрать, как организовать connection pooling и какие инструменты определить
- Настрой конфигурацию MCP для GitHub API в `.mcp.json` Claude Code с правильной аутентификацией
- Проверь, соответствует ли мой MCP-сервер спецификации 2025-06-18: JSON-RPC, обработка ошибок, управление сессиями

## Похожие
- [mcp-protocol-specialist](https://affpapa.org/nevibecode/agents/mcp-protocol-specialist.md) — субагент · 781 установка
- [mcp-server-architect](https://affpapa.org/nevibecode/agents/mcp-server-architect.md) — субагент · 1649 установок
- [mcp-protocol-stinger](https://affpapa.org/nevibecode/skills/mcp-protocol-stinger.md) — скилл · ★ 96 у репозитория
- [mcp-developer](https://affpapa.org/nevibecode/skills/mcp-developer.md) — скилл · 4600 установок
- [mcp-typescript](https://affpapa.org/nevibecode/rules/mcp-typescript.md) — правило · ★ 1198 у репозитория
- [MCP Protocol Conformance](https://affpapa.org/nevibecode/mcp/mcp-protocol-conformance.md) — MCP-сервер

Из того же набора: [coco-research/coco](https://affpapa.org/nevibecode/by/coco-research/coco.md) — 82 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
