RedashをClaudeのようなAIアシスタントと統合するためのModel Context Protocol(MCP)サーバー。

特徴

• Redash APIを通じてRedashインスタンスに接続
• 利用可能なクエリやダッシュボードをリソースとして一覧化
• クエリの実行と結果の取得
• 型付き値と保存されたデフォルトでパラメータ化された保存クエリを実行する
• クエリの作成および管理(作成、更新、アーカイブ)
• クエリパラメータ、ダッシュボードパラメータ、ウィジェットパラメータマッピングの管理
• ダッシュボードのウィジェットレイアウトやグリッド位置の検査と更新
• クエリ作成のためのデータソース一覧
• ダッシュボードの詳細と可視化の取得
• Redashチャート固有の設定でチャート可視化オプションを更新

前提条件

• Node.js(v22.13以降)
• Corepack(Node.js 22に付属;package.jsonにピン留めされたpnpmバージョンを選択します)
• Redashインスタンスへのアクセス
• Redash APIキー

環境変数

サーバーには以下の環境変数が必要です:

• REDASH_URL:あなたのRedashインスタンスURL(例:https://redash.example.com)
• REDASH_API_KEY:あなたのRedash APIキー

オプション変数:

• 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=