Nx MCP
MCP-сервер Nx: агент видит проекты монорепозитория, читает документацию Nx и разбирает упавшие CI-задачи в Nx Cloud
- 1 415 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер читает конфигурацию и граф проектов рабочей области, а через Nx Cloud получает вывод CI-задач
- `update_self_healing_fix` применяет или отклоняет исправление CI, поэтому такой вызов лучше подтверждать вручную
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/nx-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает конфигурацию и граф проектов рабочей области, а через Nx Cloud получает вывод CI-задач
- `update_self_healing_fix` применяет или отклоняет исправление CI, поэтому такой вызов лучше подтверждать вручную
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Nx MCP — сервер из репозитория Nx Console, который передает агенту сведения о монорепозитории на Nx: связи между проектами, задачи, владельцев кода, генераторы и документацию. С этим контекстом агент пишет код под ваш стек и оценивает, какие проекты заденет правка. В режиме по умолчанию (minimal) доступны `nx_docs`, `nx_current_running_tasks_details`, `nx_current_running_task_output` и `nx_visualize_graph`. Инструменты анализа рабочей области (`nx_workspace`, `nx_project_details`, `nx_generators` и еще три) возвращает флаг `--no-minimal`. Если в рабочей области подключен Nx Cloud, добавляются `ci_information`, `ci_task_output` и `update_self_healing_fix`. Агент смотрит упавшие CI-задачи с их выводом, а исправление, которое предложил Nx Cloud, применяет, отклоняет или отправляет на повтор. Недавние запуски CI сервер отдает еще и как ресурсы MCP.
Для кого. Разработчикам монорепозиториев на Nx, которые работают с агентом в Claude Code, Cursor или VS Code и хотят, чтобы он видел структуру рабочей области.
Подходит, если
- Агент правит общую библиотеку, и надо выяснить, какие приложения от нее зависят
- Для нового проекта агент подбирает генератор Nx и читает схему его параметров (с флагом `--no-minimal`)
- В Nx Cloud упала сборка в CI, и вывод упавшей задачи агент разбирает сам
- Вопрос о возможностях Nx получает ответ по разделам документации, которые отдает `nx_docs`
Не подходит, если
- Рабочая область без Nx: ответы строятся на графе проектов Nx, без него сервер бесполезен
- Данные CI нужны без Nx Cloud: инструменты `ci_information` и `ci_task_output` в такой рабочей области не появятся
- Агенту сразу требуется полный набор анализа: без `--no-minimal` часть инструментов спрятана
Пример запроса к агенту
Какие проекты монорепозитория заденет правка в libs/shared/ui и какие задачи придется перезапустить?MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
- Инструменты CI работают только при включенном Nx Cloud.
- В минимальном режиме по умолчанию шесть инструментов анализа рабочей области скрыты, их возвращает `--no-minimal`.
- `nx_visualize_graph` требует запущенной IDE.
- Без пути к рабочей области доступны только `nx_docs` и `nx_available_plugins`.
- Транспорт SSE удален, по сети сервер отдает только Streamable HTTP, по умолчанию на порту 9921.
- Расширение Nx Console само управляет сервером только в Cursor, в остальных клиентах его добавляют вручную.
Как отключить. Команда `claude mcp remove nx-mcp` убирает сервер из Claude Code. В других клиентах удаляют запись `nx-mcp` из `mcp.json`. Телеметрию сервера отключает `"disableTelemetry": true` в файле `.nx/nx-mcp-config.json`.
Частые вопросы
Как подключить Nx MCP к Claude Code?
Выполните `claude mcp add nx-mcp npx nx-mcp@latest`. Сервер запускается через `npx` по stdio, ключи не нужны. Откройте Claude Code в каталоге рабочей области Nx и попросите описать проекты.
Почему агент не видит nx_workspace и nx_generators?
Эти инструменты скрыты в минимальном режиме, который включен по умолчанию. Запустите сервер с флагом: `npx nx-mcp@latest --no-minimal`. Тогда в списке появятся все шесть инструментов анализа.
Как запустить Nx MCP по HTTP?
Добавьте `--transport http`, порт задает `--port`, по умолчанию 9921. Клиент подключается к `http://localhost:<port>/mcp` по Streamable HTTP, одновременно работают несколько клиентов. Транспорт SSE удален.
Нужен ли для работы Nx Cloud?
Нет, документация, запущенные задачи и граф работают без него. Инструменты `ci_information`, `ci_task_output`, `update_self_healing_fix` и ресурсы с запусками CI появляются только в рабочей области с Nx Cloud.
Как настроить сервер без аргументов командной строки?
Положите `.nx/nx-mcp-config.json` в корень рабочей области. Ключи `tools`, `minimal`, `debugLogs`, `disableTelemetry`, `transport` и `port` повторяют параметры CLI, а аргументы командной строки приоритетнее файла.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПрозрачный прокси между ИИ-клиентом и MCP-сервером: показывает каждый кадр JSON-RPC в терминале, проверяет запись в CI и экспортирует спаны
MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
MCP-сервер, который один раз строит граф кода проекта и отдает агенту готовые ответы вместо повторного перечитывания файлов
MCP-сервер в одном бинарнике: ИИ читает и правит файлы нескольких проектов и запускает ваши команды
add-mcp одной командой прописывает MCP-сервер в конфигурации 25 агентов: Claude Code, Codex, Cursor, VS Code, Zed и других
Консольный отладчик MCP-серверов от Giant Swarm: REPL для инструментов, OAuth 2.1 и режим MCP-сервера для Cursor
Коротко о README
README открывается описанием сервера и двумя способами его использовать: пакет `nx-mcp` через `npx` или расширение Nx Console, которое в Cursor управляет сервером само. Дальше описаны минимальный режим, список инструментов, ресурсы Nx Cloud и файл конфигурации. Раздел для контрибьюторов объясняет сборку через `nx run nx-mcp:build` и проверку в MCP Inspector.