Installation

Installing NGMCP

Requirements

• Python 3.12 or later
• uv (recommended)

Via uvx

The easiest way to run ngmcp without a permanent installation:

uvx ngmcp

Via uv

Alternatively you can install as a global tool:

uv tool install ngmcp

If you don't have uv installed you can use uvx.sh to perform the installation. For GNU/Linux or macOS or similar:

curl -LsSf uvx.sh/ngmcp/install.sh | sh

or on Windows:

powershell -ExecutionPolicy ByPass -c "irm https://uvx.sh/ngmcp/install.ps1 | iex"

Via uv add

To add ngmcp as a dependency of your own project:

uv add ngmcp

Via pipx

pipx install ngmcp

Via pip

pip install ngmcp

Adding to your agent

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"
    }
  }
}

GitHub Copilot CLI

Add the following to ~/.copilot/mcp-config.json:

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