Dashboards MCP

MCP (Model Context Protocol) server that gives Claude read-only access to dashboard databases.

Requirements

• uv — install once: curl -LsSf https://astral.sh/uv/install.sh | sh
• BASE_URL and AUTH_KEY — provided separately

Connecting to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "dashboards": {
      "command": "uvx",
      "args": [
        "dashboards-mcp"
      ],
      "env": {
        "BASE_URL": "https://your-api-gateway.example.com",
        "AUTH_KEY": "your_secret_key"
      }
    }
  }
}

Restart Claude Desktop. The server installs and starts automatically.

Connecting to Claude Code (CLI)

claude mcp add dashboards \
  -e BASE_URL=https://your-api-gateway.example.com \
  -e AUTH_KEY=your_secret_key \
  -- uvx dashboards-mcp

Local development

cp .env.example .env  # fill in BASE_URL and AUTH_KEY
uv run --env-file .env dashboards-mcp

Updating

To pick up the latest version, remove the cached install and restart Claude:

uv cache clean

Environment variables

Available tools

Only SELECT statements are allowed. Results are capped at MAX_ROWS rows by default.