Aurora

Reference

MCP.json reference

Configuring Aurora MCP with MCP.JSON

Prerequisites

Where is your MCP.JSON file?

Your MCP.JSON file is located in a different location depending on your client of choice. The below is a list of default locations for the MCP.JSON file for our supported clients.

  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (note, you can create this by going to claude > settings > Developer > Edit Config)
  • Cursor (global MCP): ~/.cursor/settings/mcp.json
  • Cursor (project MCP): /path/to/your/project/.cursor/mcp.json
  • Windsurf: ~/.codeium/windsurf/mcp_config.json

For other clients, look to their documentation for where their MCP.JSON file is located.

Adding Aurora MCP to your MCP.JSON file

Warning:

Configuration Object Naming: Different MCP clients use different naming conventions for the server configuration object:

  • Cursor, Windsurf: Uses "mcpServers"
  • Claude Desktop, VS Code: Use "servers" instead

Make sure to check your specific client’s documentation for the correct naming convention.

MCP configuration
{
  "mcpServers": {
    "aurora": {
      "args": [
        "@514labs/aurora-mcp@latest",
        "--moose-read-tools",
        "path/to/your/moose/project"
      ],
      "command": "npx",
      "env": {
        "ANTHROPIC_API_KEY": "<your-anthropic-api-key>",
        "MOOSE_PATH": "path/to/your/moose/installation",
        "NODE_PATH": "path/to/your/node/installation",
        "PYTHON_PATH": "path/to/your/python/installation"
      }
    }
  }
}

Arguments / Environment Variables

npx path
Required
NPX path to aurora; should be `@514labs/aurora-mcp@latest`
tool flags
Required
Selected tool flags; see Tools Reference for available flags (e.g. `--moose-read-tools`, `--moose-write-tools`, `--remote-clickhouse`)
Moose Path
Path to your moose project. Not required if you are only using the `remote-clickhouse` tool.
Anthropic API Key
Your Anthropic API key. If you don't have an Anthropic API key, see the Anthropic initial setup guide: https://docs.anthropic.com/en/docs/initial-setup. This is required for using Aurora's generative MCP tools.
Moose Path
Path to your moose installation. Not required if you are only using the `remote-clickhouse` tool.
Node Path
Path to your node installation. Not required if you are only using the `remote-clickhouse` tool. Not required if you are using other tools within Python projects.
Python Path
Path to your python installation. Not required if you are only using the `remote-clickhouse` tool. Not required if you are using other tools within Python projects.

Adding tool sets to your MCP.JSON file

Recommended tools

In general, we recommend using read-only tool-sets (moose-read-tools and remote-clickhouse) with chat type clients (like Claude Desktop)

For information about toolsets, see tools reference.

MCP.JSON
"args": [
    ...
    "--moose-read-tools",
]

Moose read tools documentation

Tools reference

Data collection policy