nrwl/Nx MCP Server

Nx MCP Server

A Model Context Protocol server implementation for Nx.

Overview

The Nx MCP server gives LLMs deep access to your monorepo’s structure: project relationships, file mappings, runnable tasks, ownership info, tech stacks, Nx generators, and even Nx documentation. With this context, LLMs can generate code tailored to your stack, understand the impact of a change, and apply modifications across connected files with precision. This is possible because Nx already understands the higher-level architecture of your workspace, and monorepos bring all relevant projects into one place.

Read more in our blog post and in our docs.

Installation and Usage

There are two ways to use this MCP server:

a) Run it via the nx-mcp package

Simply invoke the MCP server via npx or your package manager's equivalent.

Here's an example of a mcp.json configuration:

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

claude mcp add nx-mcp npx nx-mcp@latest

code --add-mcp '{"name":"nx-mcp","command":"npx","args":["nx-mcp"]}'

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

Refer to your AI tool's documentation for how to register an MCP server. For example, Cursor or Claude Desktop support MCP.

If you want to host the server instead of communicating via stdio, you can use the --sse and --port flags. The HTTP transport supports multiple concurrent connections, allowing different clients to connect simultaneously with independent sessions.

Run nx-mcp --help to see what options are available.

b) Use the Nx Console extension

If you're using Cursor you can directly install the Nx Console extension which automatically manages the MCP server for you.

More info:

• Install Nx Console
• Configure Cursor to use the nx-mcp

Minimal Mode (Default)

By default, the Nx MCP server runs in minimal mode, which hides workspace analysis tools that overlap with AI tool skills/instructions. This reduces tool clutter and context window usage for AI agents that already have access to equivalent functionality through skills.

The following tools are hidden in minimal mode:

• nx_available_plugins
• nx_workspace_path
• nx_workspace
• nx_project_details
• nx_generators
• nx_generator_schema

To disable minimal mode and expose all tools, use the --no-minimal flag:

npx nx-mcp@latest --no-minimal

Available Tools

The Nx MCP server provides a comprehensive set of tools for interacting with your Nx workspace.

Always Available

• nx_docs: Returns documentation sections relevant to user queries about Nx
• nx_current_running_tasks_details: Lists currently running Nx TUI processes and task statuses
• nx_current_running_task_output: Returns terminal output for specific running tasks
• nx_visualize_graph: Visualizes the Nx graph (requires running IDE instance)

Hidden in Minimal Mode (use --no-minimal to enable)

• nx_available_plugins: Lists available Nx plugins from the core team and local workspace plugins
• nx_workspace_path: Returns the path to the Nx workspace root
• nx_workspace: Returns readable representation of project graph and nx.json configuration
• nx_project_details: Returns complete project configuration in JSON format for a given project
• nx_generators: Returns list of generators relevant to user queries
• nx_generator_schema: Returns detailed JSON schema for a specific Nx generator

Nx Cloud Tools (only available w/ Nx Cloud enabled)

These tools provide insights and interactions with your Nx Cloud CI/CD data:

• ci_information: Retrieves CI pipeline execution information for the current branch or a specific Nx Cloud CIPE URL. Supports a select parameter for field selection with pagination, making it easy to access specific data like task outputs or suggested fixes.
• update_self_healing_fix: Apply, reject, or request a rerun for a self-healing CI fix from Nx Cloud

Nx Cloud Analytics Tools (only available w/ Nx Cloud enabled)

These tools provide analytics and insights into your Nx Cloud CI/CD data, helping you track performance trends and team productivity:

• cloud_analytics_pipeline_executions_search: Analyzes historical pipeline execution data to identify trends and patterns
• cloud_analytics_pipeline_execution_details: Analyzes detailed data for a specific pipeline execution to investigate performance
• cloud_analytics_runs_search: Analyzes historical run data to track performance trends and productivity patterns
• cloud_analytics_run_details: Analyzes detailed data for a specific run to investigate command execution performance
• cloud_analytics_tasks_search: Analyzes aggregated task performance statistics including success rates and cache hit rates
• cloud_analytics_task_executions_search: Analyzes individual task execution data to investigate performance trends

When no workspace path is specified, only the nx_docs and nx_available_plugins tools will be available.

Available Resources

When connected to an Nx Cloud-enabled workspace, the Nx MCP server automatically exposes recent CI Pipeline Executions (CIPEs) as MCP resources. Resources appear in your AI tool's resource picker, allowing the LLM to access detailed information about CI runs including failed tasks, terminal output, and affected files.

Contributing & Development

Contributions are welcome! Please see the Nx Console contribution guide for more details.

The basic steps are:

1. Clone the Nx Console repository and follow installation steps
2. Build the nx-mcp using nx run nx-mcp:build (or nx run nx-mcp:build:debug for debugging with source maps)
3. Use the MCP Inspector to test out your changes

Configuration File

You can also configure the MCP server via a JSON file at .nx/nx-mcp-config.json in your workspace root. This is useful when the MCP server binary is managed by a plugin or extension where you can't pass CLI args directly.

{
  "tools": ["nx_docs", "!cloud_*"],
  "minimal": true,
  "debugLogs": false,
  "disableTelemetry": true,
  "transport": "sse",
  "port": 9922
}

All keys are optional and match the CLI option names. CLI arguments take precedence over config file values.

License