NodePilot MCP
MCP-сервер nodepilot-mcp ведет рабочие процессы NodePilot на Windows: 116 инструментов, опасные операции закрыты по умолчанию.
- 116 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Рабочие процессы выполняют PowerShell на удаленных машинах Windows, поэтому агент через NodePilot получает доступ к парку.
- Удаление процессов и машин и отмена запусков открываются флагом `NODEPILOT_MCP_ALLOW_DESTRUCTIVE=true`.
Установка
- Работает в
Ручная установка
dotnet publish src/NodePilot.Mcp -c Release -o C:\Tools\NodePilot-McpСборка из исходников. Оба установщика NodePilot уже кладут `nodepilot-mcp.exe` в `tools\mcp`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Рабочие процессы выполняют PowerShell на удаленных машинах Windows, поэтому агент через NodePilot получает доступ к парку.
- Удаление процессов и машин и отмена запусков открываются флагом `NODEPILOT_MCP_ALLOW_DESTRUCTIVE=true`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
nodepilot-mcp — тонкий HTTP-клиент к REST API платформы NodePilot, которая автоматизирует Windows и PowerShell и запускает шаги по WinRM без агентов на целевых машинах. Через MCP агент читает данные, создает и правит рабочие процессы, запускает их и разбирает выполнение. Инструментов 116, они разбиты на 12 групп. Опасные и административные инструменты, например `delete_workflow`, `cancel_all_executions` и `delete_machine`, не регистрируются совсем, пока не задано `NODEPILOT_MCP_ALLOW_DESTRUCTIVE=true`. Вызов `get_safety_status` показывает активный режим и список закрытых инструментов.
Для кого. Системные администраторы, которые автоматизируют парк Windows в NodePilot и хотят вести рабочие процессы через агента.
Подходит, если
- Агент собирает рабочий процесс из шагов PowerShell, REST и SQL и публикует его.
- Упавший запуск разбирают по статусу шагов и выводу, не открывая веб-интерфейс.
- Агент читает данные NodePilot: рабочие процессы, запуски, версии.
- Опасные операции остаются закрытыми, а агенту доступны чтение и правка без удаления.
Не подходит, если
- Windows в инфраструктуре нет: сервер собран под `net10.0-windows` и хранит сессию в DPAPI.
- Запуск идет на Linux или в CI без токена: DPAPI-сессии там нет, подойдет только `NODEPILOT_MCP_TOKEN`.
- Агенту собираются разрешить удаление процессов и машин без присмотра.
Пример запроса к агенту
Покажи рабочие процессы с упавшими запусками за сутки, разбери последнюю ошибку и предложи правку. Ничего не удаляй.MCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
NODEPILOT_MCP_SERVERобязательная- Адрес сервера NodePilot
NODEPILOT_MCP_TOKENсекрет- Bearer-токен для CI и безголовых запусков вместо сессии `np auth login`
NODEPILOT_MCP_ALLOW_DESTRUCTIVE- Значение `true` регистрирует опасные и административные инструменты
Ограничения
Только Windows. Нужен развернутый NodePilot и вход командой `np auth login`. Пакетом `dotnet tool` сервер не ставится из-за ограничения NETSDK1146: исполняемый файл лежит в `tools\mcp` установщиков либо собирается командой `dotnet publish`. Работает по stdio, Streamable HTTP описан как будущая возможность. Адрес сервера и токен задают переменными `NODEPILOT_MCP_SERVER` и `NODEPILOT_MCP_TOKEN`. Токен без обновления подходит только для коротких запусков.
Как отключить. Уберите запись `nodepilot` из `.mcp.json` клиента и удалите исполняемый файл. Сохраненную `np`-сессию в `%APPDATA%\NodePilot` очистите командой выхода CLI.
Частые вопросы
Как включить опасные инструменты?
Задайте `NODEPILOT_MCP_ALLOW_DESTRUCTIVE=true`. Пока переменной нет, такие инструменты не видны агенту в `tools/list`.
Как узнать, какие инструменты закрыты?
Вызовите `get_safety_status`: он показывает активный режим и перечень закрытых инструментов.
Как авторизоваться без интерактивного входа?
Для CI и безголовых запусков задайте `NODEPILOT_MCP_TOKEN` с bearer-токеном. Обновление такого токена сервер не делает.
Работает ли сервер на Linux?
Нет. Сборка `net10.0-windows` использует DPAPI для хранения сессии, как и весь NodePilot.
Какой транспорт у сервера?
Только stdio. Streamable HTTP в документации назван будущей возможностью.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыМенеджер MCP-серверов на Node.js: запускает локальные и подключает удаленные серверы и отдает их клиенту одним адресом с REST API для управления
MCPM
mcpm
Менеджер пакетов и реестр MCP для всех платформ и клиентов: ищет, добавляет и настраивает MCP-серверы, запоминает источник и обновляет
Защищенный MCP-рантайм, через который агент управляет локальными машинами, серверами и контейнерами
MCP-сервер для Windows: агент ищет программы, твики и DNS в каталоге WinUtil CN, а установку и правки включает только флаг и подтверждение
MCP-сервер для ServiceNow: больше 500 инструментов по ITSM, CMDB и скриптингу, запись выключена по умолчанию
Dokploy MCP
Dokploy MCP Server
Официальный MCP Dokploy открывает агенту 508 инструментов API: проекты, приложения, базы, Docker и резервные копии.
Коротко о README
Сервер ничего не добавляет к бэкенду: каждый инструмент вызывает существующую конечную точку REST API NodePilot или считает локально на `NodePilot.Core`. Настройки берутся из переменных окружения и профиля `np`.