Installation

Requirements

• Python 3.12 or later
• uv (recommended)

Via uvx

The easiest way to run ngmcp without a permanent installation:

uvx ngmcp

Via uv add

To add ngmcp as a dependency of your own project:

uv add ngmcp

Via pip

pip install ngmcp

Claude Desktop

Add the following to your claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "ngmcp": {
      "command": "uvx",
      "args": ["ngmcp"],
      "env": {
        "NGMCP_GUIDE_DIRS": "/path/to/your/ng/files"
      }
    }
  }
}

Restart Claude Desktop after saving the configuration.

Cursor

In your Cursor settings under MCP Servers, add:

{
  "ngmcp": {
    "command": "uvx",
    "args": ["ngmcp"],
    "env": {
      "NGMCP_GUIDE_DIRS": "/path/to/your/ng/files"
    }
  }
}