Сервер Model Context Protocol (MCP) для интеграции Redash с AI-ассистентами, такими как Claude.

Особенности

• Подключение к экземплярам Redash через API Redash
• Перечислить доступные запросы и панели управления в качестве ресурсов
• Выполнять запросы и получать результаты
• Выполнение сохранённых параметризованных запросов с типизированными значениями и сохранёнными значениями по умолчанию
• Создание и управление запросами (создание, обновление, архивирование)
• Управление параметрами запросов, параметрами панели управления и отображением параметров виджетов
• Инспектировать и обновлять схемы виджетов и позиции в сетках панелей
• Список источников данных для создания запросов
• Получить детали панели управления и визуализации
• Обновление опций визуализации диаграмм с помощью специфических настроек Redash

Предварительные требования

• Node.js (v22.13 или новее)
• Corepack (в комплекте с Node.js 22; он выбирает pnpm-версию, закреплённую в package.json)
• Доступ к экземпляру Redash
• Ключ Redash API

Переменные среды

Серверу требуются следующие переменные среды:

• REDASH_URL: URL вашего экземпляра Redash (например, https://redash.example.com)
• REDASH_API_KEY: Ваш ключ API Redash

Опциональные переменные:

• REDASH_TIMEOUT: Таймаут для запросов API в миллисекундах (по умолчанию: 30000)

Redash MCP Server

Model Context Protocol (MCP) server for integrating Redash with AI assistants like Claude.

Features

• Connect to Redash instances via the Redash API
• List available queries and dashboards as resources
• Execute queries and retrieve results
• Execute saved parameterized queries with typed values and saved defaults
• Create and manage queries (create, update, archive)
• Manage query parameters, dashboard parameters, and widget parameter mappings
• Inspect and update dashboard widget layouts and grid positions
• List data sources for query creation
• Get dashboard details and visualizations
• Update chart visualization options with Redash chart-specific settings

Prerequisites

• Node.js (v22.13 or later)
• Corepack (included with Node.js 22; it selects the pnpm version pinned in package.json)
• Access to a Redash instance
• Redash API key

Environment Variables

The server requires the following environment variables:

• REDASH_URL: Your Redash instance URL (e.g., https://redash.example.com)
• REDASH_API_KEY: Your Redash API key

Optional variables:

• REDASH_TIMEOUT: Timeout for API requests in milliseconds (default: 30000)
• REDASH_MAX_RESULTS: Maximum number of results to return (default: 1000)
• REDASH_EXTRA_HEADERS: Extra HTTP headers to include with every Redash request. Accepts either a JSON object string or a semicolon/comma-separated list of key=value pairs.
• REDASH_SOCKS_PROXY: SOCKS proxy URL for routing requests through a proxy (e.g., socks5h://localhost:1080). Use socks5h:// (with h) to delegate DNS resolution to the proxy, which is required for internal hostnames that don’t resolve on the local machine.
• MCP_TRANSPORT: MCP transport to use. Supported values are stdio, http, and streamable-http (default: stdio).
• MCP_HTTP_HOST: Host for Streamable HTTP mode (default: 127.0.0.1).
• MCP_HTTP_PORT: Port for Streamable HTTP mode (default: 3000).
• MCP_HTTP_PATH: Streamable HTTP endpoint path (default: /mcp).
• MCP_HTTP_ALLOWED_HOSTS: Comma-separated Host header allowlist for Streamable HTTP mode. Values are hostnames without a scheme, port, path, or wildcard.
• MCP_HTTP_ALLOWED_ORIGINS: Comma-separated browser Origin hostname allowlist. Values use the same hostname-only format and also control CORS responses. Set an empty value to reject every request that includes an Origin header.
• OpenTelemetry variables: optional; see OpenTelemetry observability for concrete OTLP and Prometheus configurations.

Examples:

JSON (recommended):

REDASH_EXTRA_HEADERS='{"CF-Access-Client-Id":"","CF-Access-Client-Secret":""}'

Key/value list:

REDASH_EXTRA_HEADERS=CF-Access-Client-Id=;CF-Access-Client-Secret=