Sub-Agents MCP Server
MCP-сервер запускает субагентов, описанных в Markdown, через Codex, Claude Code, Cursor CLI и другие CLI из любого MCP-клиента
- 98 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Запускает установленные кодинг-CLI, которые читают и правят файлы проекта, режим yolo снимает ограничения
- Границы прав AGENT_PERMISSION зависят от бэкенда и служат ориентиром
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/sub-agents-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Запускает установленные кодинг-CLI, которые читают и правят файлы проекта, режим yolo снимает ограничения
- Границы прав AGENT_PERMISSION зависят от бэкенда и служат ориентиром
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Sub-Agents MCP Server запускает многоразовых агентов по описанию в Markdown. Роль (ревьюер, автор тестов, расследователь багов, автор документации) записывается в файл `code-reviewer.md` в выбранной папке, имя файла становится именем агента. Сервер подключается к MCP-клиенту, а по просьбе вроде «используй агента code-reviewer для проверки правок авторизации» запускает выбранный CLI и возвращает результат в тот же разговор. Бэкенд задает переменная `AGENT_TYPE`: `codex`, `claude`, `cursor`, `command-code`, `glm`, `kimi`, `grok`, `antigravity`, `gemini`, `opencode`, `mcode` или `pi`. Модель общая для всех агентов (`AGENT_MODEL`), права задает `AGENT_PERMISSION`: `read-only`, `safe-edit` (по умолчанию) или `yolo`. С включенным `SESSION_ENABLED` агент продолжает работу между вызовами по `session_id`. Серверу нужны Node.js 22 или новее и один установленный и авторизованный CLI. Для GLM и Kimi в окружение добавляют `CLI_API_KEY`.
Для кого. Разработчикам, которые хотят вызывать ревьюера или автора тестов из Claude Desktop, Cursor или другого MCP-клиента и держать определения агентов в одной папке.
Подходит, если
- Ревью правок должен делать отдельный агент с понятной инструкцией вместо общего чата
- Одни и те же агенты нужны в нескольких MCP-клиентах, а бэкенд и модель настраиваются в одном месте
- Длинную задачу надо вести несколькими вызовами с памятью, включив `SESSION_ENABLED`
- Расследование упавшего чекаута стоит поручить агенту только на чтение с режимом `read-only`
Не подходит, если
- Нужен самый легкий вариант: у автора есть отдельный проект Sub-Agents Skills без сервера
- Каждый агент должен выбирать свой бэкенд и модель: у сервера они общие на все
- Нужна жесткая граница безопасности: права `AGENT_PERMISSION` зависят от бэкенда и считаются ориентиром
Пример запроса к агенту
Используй агента code-reviewer, чтобы проверить правки авторизации в текущей веткеMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
AGENTS_DIRобязательная- Абсолютный путь к папке с файлами агентов (.md или .txt)
AGENT_TYPEобязательная- Бэкенд: codex, claude, cursor, gemini, opencode и другие
AGENT_PERMISSION- read-only, safe-edit (по умолчанию) или yolo
CLI_API_KEYсекрет- Ключ для бэкендов GLM и Kimi
Ограничения
- Нужны Node.js 22 или новее и один установленный и авторизованный CLI из списка бэкендов, иначе сервер не запустится.
- Бэкенд и модель общие для всех агентов, а раздельный выбор для каждого агента дает отдельный проект Sub-Agents Skills.
- Режимы `AGENT_PERMISSION` по словам автора служат ориентиром и границей безопасности не считаются: строгость зависит от бэкенда. Режим `yolo` снимает все ограничения.
- Для GLM и Kimi нужен `CLI_API_KEY`, остальные бэкенды берут авторизацию из своего CLI.
Как отключить. Удалите блок `sub-agents` из конфигурации MCP-клиента и перезапустите клиент. Папка с описаниями агентов остается на диске, ее можно удалить вручную.
Частые вопросы
Как подключить Sub-Agents MCP к Claude Desktop или Cursor?
Добавьте в конфигурацию MCP сервер `sub-agents` с командой `npx -y sub-agents-mcp` и переменными `AGENTS_DIR` (абсолютный путь к папке агентов) и `AGENT_TYPE` (например `codex`). После сохранения перезапустите клиент.
Как описать агента?
Создайте Markdown-файл, например `code-reviewer.md`, с заголовком, разделами `Task` и `Done When`. Имя файла без расширения станет именем агента, а файлы `.md` и `.txt` из `AGENTS_DIR` подхватываются автоматически.
Какие права получает субагент?
Их задает `AGENT_PERMISSION`: `read-only` для проверки и расследований, `safe-edit` (по умолчанию) разрешает правки без подтверждения, `yolo` снимает ограничения. Строгость зависит от бэкенда.
Какие бэкенды поддерживаются?
Codex, Claude Code, Cursor CLI, Command Code, GLM, Kimi, Grok Build, Google Antigravity, Gemini CLI, OpenCode, MiniMax Code и Pi. Выбранный CLI должен быть установлен и авторизован до запуска сервера.
Почему агент не запускается?
Проверьте, что выбранный CLI работает сам по себе в терминале и авторизован, `AGENTS_DIR` задан абсолютным путем и содержит хотя бы один файл `.md` или `.txt`, а клиент перезапущен после правки конфигурации.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер UseAgent передает задачи удаленным агентам, собирает результаты и сохраняет запуски в журнале организации.
ReevesAgents запускает Claude Code, Codex, Hermes и других CLI-агентов рядом в tmux, а MCP дает одному вести остальных.
MCP Agent Mail
mcp_agent_mail
Почтовый слой координации для кодовых агентов: у агентов постоянные имена, входящие и исходящие, поиск по истории и добровольные резервы файлов
Мост между локальными CLI-агентами: Codex, Cursor или Claude Code делегируют работу Antigravity, Grok, Kimi и еще семи агентам.
PromptOps держит Claude Code, Codex и Gemini CLI рядом по проектам и дает ведущему агенту MCP для запуска помощников
MCP-сервер общей комнаты для агентов: решения, задачи с проверкой другим агентом и итоговый отчет, вход по коду.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Sub-Agents MCP Server (эта карточка) | нет | не нужна | 98 | |
| pi-subagents | нет | 1 449 | плагин субагентов для Pi, моста на разные CLI в нем нет | |
| Oh My Subagents | нет | 180 | локальная служба для команд субагентов Codex и Claude с учетом состояния задач |
Коротко о README
README ведет по трем шагам: создать файл агента, добавить сервер в конфигурацию MCP, вызвать агента просьбой. Дальше идут примеры просьб, таблица бэкендов с командами CLI, общие настройки модели и прав, сессии между вызовами и советы на случай, когда сервер не стартует.