Director CLI
Director собирает MCP-серверы, промпты и настройки в плейбуки и отдает агенту одним адресом, с OAuth в одном месте и фильтрацией инструментов
- 482 ★ репозитория
- Последний коммит
- AGPL-3.0
Широкий доступ
Почему такой уровень
- Хранит OAuth-доступы к подключенным MCP-серверам и проксирует вызовы агента через свой шлюз
- Командой connect меняет конфигурацию клиентов Claude Code, Claude Desktop, Cursor и VS Code
- Запускает MCP-серверы через npx и uvx, а установочный скрипт ставит Node, npm и uvx
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/fdmtl-directorОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Хранит OAuth-доступы к подключенным MCP-серверам и проксирует вызовы агента через свой шлюз
- Командой connect меняет конфигурацию клиентов Claude Code, Claude Desktop, Cursor и VS Code
- Запускает MCP-серверы через npx и uvx, а установочный скрипт ставит Node, npm и uvx
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Director стоит между агентом и MCP-серверами. Плейбук — набор MCP-инструментов, промптов и настроек для конкретной задачи или окружения, плейбуков может быть много. Агент подключается к плейбуку одной командой или по URL, поэтому переключать наборы можно без правки конфигов вручную. CLI называется director и ставится пакетом @director.run/cli. Команда director `create` создает плейбук, director `add` кладет в него сервер из реестра, director connect привязывает плейбук к клиенту: Claude Code, Claude Desktop, Cursor или VS Code. Команда director `studio` открывает веб-интерфейс для тех же операций, а director mcp `call-tool` вызывает инструмент плейбука напрямую для проверки. Среди возможностей: фильтр инструментов, чтобы не занимать контекст лишним, общий вход через OAuth для серверов, которые его требуют, централизованный лог в JSON и команда http2stdio, которая превращает HTTP-подключение в stdio-поток. Для встраивания есть TypeScript SDK @director.run/sdk и Docker-образ.
Для кого. Для разработчиков, у которых к Claude Code, Cursor и другим клиентам подключено много MCP-серверов и нужно держать для каждой задачи свой короткий набор.
Подходит, если
- MCP-серверов накопилось много, и для разных задач нужны разные наборы инструментов без переписывания конфигов клиента
- Нужно оставить агенту только часть инструментов сервера, чтобы не расходовать контекст на лишние описания
- Несколько агентов должны ходить к одним и тем же OAuth-серверам с общей авторизацией
- Хочется видеть в JSON-логе, какие вызовы делает агент
- Сервера MCP нужно запускать внутри Docker-контейнера, а не на хосте
Не подходит, если
- Подключен один-два MCP-сервера, и прямая запись в конфиг клиента проще
- Нужен только каталог серверов для поиска, без шлюза между агентом и серверами
- Лицензия AGPL-3.0 не подходит для вашего проекта, если вы собираетесь встраивать код Director
- Среда не допускает установку через curl-скрипт и нет возможности поставить пакет через npm
Пример запроса к агенту
Создай в Director плейбук для работы с документацией, добавь в него сервер `fetch` и подключи к Claude CodeОграничения
- Лицензия AGPL-3.0.
- Сервис работает локально, для общего доступа его нужно запускать самим: в репозитории есть Docker-образ и SDK, а размещенной версии для установки нет.
- Клиенты с готовой кнопкой подключения: Claude Code, Claude Desktop, Cursor, VS Code. Для остальных используется адрес плейбука вручную.
- Установочный скрипт ставит Node, npm и uvx вместе с CLI.
- Серверы из реестра запускаются на вашей машине через npx и uvx, поэтому у них те же права, что у вашего пользователя, пока вы не запустите Director в Docker.
Как отключить. Команда director `disconnect` <playbookId> отвязывает плейбук от клиента, director `destroy` <playbookId> удаляет плейбук. Сам CLI снимается командой npm `uninstall` -g @director.run/cli.
Частые вопросы
Что такое плейбук в Director?
Набор MCP-инструментов, промптов и настроек для одной задачи или окружения. Плейбук строится на MCP-примитивах `tools` и `prompts`, подключается к клиенту командой или доступен по одному URL.
Как подключить плейбук Director к Claude Code?
Создайте плейбук командой director `create`, добавьте сервер командой director `add` и выполните director connect <имя> --target claude. Клиенты, которые поддерживает кнопка подключения: Claude Code, Claude Desktop, Cursor и VS Code.
Чем Director отличается от прямого подключения MCP-серверов?
Клиент видит один MCP-адрес вместо списка серверов, а Director фильтрует инструменты, ведет единую авторизацию OAuth и пишет общий JSON-лог. Плейбуки можно менять местами, не трогая конфиг клиента.
Как поставить Director?
Командой curl -LsSf https://director.run/install.sh | sh: она ставит CLI вместе с Node, npm и uvx. Альтернатива: npm install -g @director.run/cli. Затем выполните director quickstart, он запустит шлюз и откроет студию в браузере.
Есть ли у Director программный интерфейс?
Да, TypeScript SDK @director.run/sdk: Gateway.start поднимает шлюз с конфигурацией, а playbookStore.create создает плейбук с перечнем серверов. Docker-образ barnaby/director запускает Director и MCP-серверы внутри контейнера.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыУниверсальный CLI-клиент MCP от Apify: постоянные сессии, OAuth, JSON-вывод для скриптов и доступ агента к любому MCP-серверу через оболочку
CLI, который на лету превращает любой MCP-сервер, спецификацию OpenAPI или GraphQL-эндпоинт в набор команд без генерации кода
CLI на Python без зависимостей: один каталог MCP-серверов и скиллов для всех агентов, в контекст попадает краткий индекс
CLI для любого MCP-сервера: список и вызов инструментов, ресурсов и промптов, mock и proxy режимы, guard-фильтр и управление конфигами агентов
Плагин для агента: управляет организацией в deco Studio из терминала под вашим входом, через CLI decocms
Мост для MCP: один инструмент run_python запускает код в контейнере и вызывает ваши MCP-серверы
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Director (эта запись) | нет | 482 | ||
| MCPM | нет | 1 016 | пакетный менеджер и реестр для установки MCP-серверов в клиенты, без плейбуков с промптами | |
| capa | нет | 718 | пакетный менеджер и шлюз MCP, возможности агента описываются одним файлом capabilities.yaml | |
| Docker MCP Gateway | да | не нужна | 1 616 | шлюз Docker запускает серверы из каталога Docker в изолированных контейнерах, без студии и плейбуков |
Коротко о README
Главная страница называет Director слоем плейбуков для ИИ-агентов и начинается со строки установки. В обзоре перечислены возможности: плейбуки, подключение в один шаг, общий адрес, локальная работа, единый OAuth, фильтрация инструментов, журналирование и совместимость со спецификацией MCP. Дальше идут установка, веб-студия, справочник команд CLI, пример на TypeScript SDK и список приложений монорепозитория: шлюз, CLI, SDK, Docker, документация, реестр и студия.