Nx MCP Server

An agent dropped into an Nx monorepo sees a directory tree and has to infer the rest: which projects exist, what depends on what, which target runs the tests, whether a generator already scaffolds the thing it is about to hand-write. The Nx MCP Server removes the guessing by exposing the workspace's own metadata over the Model Context Protocol.

What it exposes

The server reads the same project graph Nx uses to schedule tasks, so the agent gets project relationships and file-to-project mapping, runnable targets, code ownership, the tech stack per project, the list of installed Nx plugins and their generators (with each generator's schema), and Nx's documentation. On an Nx Cloud workspace it also surfaces CI information, task output, and the self-healing fix flow.

The practical effect is that a change stops being local. Ask for a rename or an API change and the agent can see which projects consume the code and follow the change through them; ask for a new library and it can call the generator the workspace already has rather than inventing a folder layout.

Running it

It ships as the nx-mcp npm package and needs no install:

{
  "servers": {
    "nx-mcp": { "type": "stdio", "command": "npx", "args": ["nx-mcp@latest"] }
  }
}

By default it runs in a minimal mode that registers only nx_docs, nx_current_running_tasks_details, nx_current_running_task_output and nx_visualize_graph, keeping the client's tool list short; --no-minimal turns on the rest (nx_workspace, nx_project_details, nx_generators, nx_generator_schema, nx_available_plugins, nx_workspace_path). A .nx/nx-mcp-config.json file pins the choice per repository, with an allow/deny list ("tools": ["nx_docs", "!cloud_*"]), telemetry opt-out and debug logging; CLI flags override it. --sse with --port runs it over HTTP for concurrent clients instead of stdio.

If you already use the Nx Console extension in VS Code or Cursor, it manages the server for you and no manual config is needed.

Who it is for

Teams on Nx who have handed real refactoring work to an agent and are tired of it touching one project and breaking three. It is maintained by Nrwl inside the Nx Console repository, alongside the editor extension.