Nx MCP Setup

This workspace is configured with the Nx Model Context Protocol (MCP) server, which allows AI assistants to interact with your Nx workspace.

Quick Start

You can start the MCP server using:

pnpm mcp:start

Or directly:

npx nx-mcp .

To configure your AI agent (like Claude Code or Cursor) to use the Nx MCP server:

npx nx configure-ai-agents

This will guide you through setting up the MCP server for your preferred AI assistant.

Add the Nx MCP server to Claude Code:

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

Or add it manually to your Claude Code configuration:

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

Add to your Cursor settings (.cursor/mcp.json or similar):

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

The Nx MCP server gives your AI assistant:

Workspace Structure Understanding: Full awareness of your monorepo's architecture and project dependencies
Real-time Terminal Integration: Access to terminal outputs and running processes
CI Pipeline Context: Insights into build failures and test results
Enhanced Code Generation: AI-powered generator suggestions
Cross-project Impact Analysis: Understanding implications of changes across the monorepo
Autonomous Error Debugging: AI-assisted issue identification and resolution