# sub-agents-mcp

Запускает ваших субагентов с описанием в Markdown через выбранный кодинг-CLI и возвращает ответ в ту же беседу. Пригодится, когда ревью, тесты и разбор багов хочется поручить отдельным агентам.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 98
- Автор: shinpr
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/shinpr/sub-agents-mcp
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/sub-agents-mcp

## Что делает

Агент — это файл Markdown в папке, путь к которой вы задаёте в `AGENTS_DIR`. Имя файла становится именем агента: `code-reviewer.md` превращается в `code-reviewer`. Внутри описываете задачу и критерии готовности. Дальше просите ассистента вызвать агента, сервер запускает его через бэкенд из `AGENT_TYPE` и отдаёт результат обратно в разговор.

Бэкенд выбирается переменной `AGENT_TYPE`: `codex`, `claude`, `cursor`, `command-code`, `glm`, `kimi`, `grok`, `antigravity`, `gemini`, `opencode`, `mcode`, `pi`. Этим же полем задаётся CLI, который должен быть установлен и авторизован до старта сервера. Для GLM и Kimi понадобится `CLI_API_KEY` в окружении; у остальных берётся их собственная авторизация. Ещё есть `AGENT_PERMISSION`: `read-only`, `safe-edit` (по умолчанию) или `yolo`. Насколько строго уровень соблюдается, зависит от бэкенда, так что как граница безопасности он не годится.

Нужен Node.js 22 или новее и MCP-клиент. Если агент жалуется, что действие заблокировано, ослабьте режим. `AGENT_MODEL` задаёт одну модель сразу для всех агентов. Флаг `SESSION_ENABLED` включает память между вызовами, и тогда ассистент должен передавать полученный `session_id` в следующий запрос. Агенты общие для всех клиентов, а настройки бэкенда и модели лежат в одном месте.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `AGENTS_DIR`, `AGENT_TYPE`, `AGENT_PERMISSION`, `AGENT_MODEL`, `AGENT_EFFORT`, `CURSOR_API_KEY`, `CLI_API_KEY`, `EXECUTION_TIMEOUT_MS`, `SESSION_ENABLED`, `SESSION_DIR` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env AGENTS_DIR=<AGENTS_DIR> --env AGENT_TYPE=<AGENT_TYPE> --env AGENT_PERMISSION=<AGENT_PERMISSION> --env AGENT_MODEL=<AGENT_MODEL> --env AGENT_EFFORT=<AGENT_EFFORT> --transport stdio sub-agents-mcp -- npx -y sub-agents-mcp
```
Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add sub-agents-mcp --env AGENTS_DIR=<AGENTS_DIR> --env AGENT_TYPE=<AGENT_TYPE> --env AGENT_PERMISSION=<AGENT_PERMISSION> --env AGENT_MODEL=<AGENT_MODEL> --env AGENT_EFFORT=<AGENT_EFFORT> -- npx -y sub-agents-mcp
```
Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sub-agents-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "sub-agents-mcp"
            ],
            "env": {
                "AGENTS_DIR": "<AGENTS_DIR>",
                "AGENT_TYPE": "<AGENT_TYPE>",
                "AGENT_PERMISSION": "<AGENT_PERMISSION>",
                "AGENT_MODEL": "<AGENT_MODEL>",
                "AGENT_EFFORT": "<AGENT_EFFORT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "sub-agents-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "sub-agents-mcp"
            ],
            "env": {
                "AGENTS_DIR": "<AGENTS_DIR>",
                "AGENT_TYPE": "<AGENT_TYPE>",
                "AGENT_PERMISSION": "<AGENT_PERMISSION>",
                "AGENT_MODEL": "<AGENT_MODEL>",
                "AGENT_EFFORT": "<AGENT_EFFORT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e AGENTS_DIR=<AGENTS_DIR> -e AGENT_TYPE=<AGENT_TYPE> -e AGENT_PERMISSION=<AGENT_PERMISSION> -e AGENT_MODEL=<AGENT_MODEL> -e AGENT_EFFORT=<AGENT_EFFORT> sub-agents-mcp npx -y sub-agents-mcp
```
Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера

## Когда брать
- вынести ревью изменений в отдельного агента с чёткими критериями
- дописать тесты на модуль силами выделенного субагента
- найти причину падающих запросов в оплате
- описать изменения публичного API в документации
- переиспользовать одни и те же агенты в нескольких редакторах

## Примеры запросов агенту
- Вызови агента `code-reviewer` и проверь изменения в аутентификации
- Попроси агента `test-writer` добавить тесты на модуль авторизации
- Запусти агента `bug-investigator` и разберись, почему падают запросы на оформление заказа

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160

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

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