redash-mcp

redash-mcp

English | 한국어 | 日本語

RedashをClaude、Cursor、Gemini CLI、Codex、およびあらゆるMCPクライアントに接続するMCPサーバーです。自然言語でデータをクエリし、チャートやダッシュボードを作成し、SQLを実行できます。

インストール · ツール · 環境変数 · 使用例 · トラブルシューティング · プライバシーポリシー

3.5の新機能

• create_visualization — 保存済みクエリに、折れ線／縦棒／面／円／散布図、またはカウンターを作成します。クエリが実行済みの場合は、列名が最新の結果と照合されるため、入力ミスがあれば空のチャートではなくエラーが返されます。
• ダッシュボードの自動レイアウト — add_widgetは新しいウィジェットを既存のウィジェットの下に配置します。幅半分のウィジェットは横並びになります（以前はすべて左上で重なっていました）。

全履歴：リリース

redash-mcpを選ぶ理由

LLMが本番環境のデータを安全に扱えるように構築されています。

• 🛡️ SQL安全ガード — DROP／TRUNCATE／ALTER、およびWHEREのないDELETE／UPDATEをブロックします。strict／warn／offモード、PII検出、自動LIMITに対応しています。
• 🧠 BIRDスマートクエリ — 質問を分析し、テーブルを自動選択して、SQL生成をガイドします（BIRD text-to-SQL）。オプションでClaude Haikuへのフォールバックも利用できます。
• 📊 エンドツーエンド対応 — クエリ、保存、チャート、ダッシュボード、アラートに対応する25個のツールを備えています。
• ⚡ 1コマンドでセットアップ — npx redash-mcp setupでClaude Desktop／Claude Code／Cursor／Gemini CLI／Codex CLIを設定できます。
• 🔒 完全ローカル — Redashに直接接続します。APIキーと結果がマシンの外に出ることはありません。

インストール

必要なもの： Node.js 20以降とRedash APIキー（Redash → Profile → Edit Profile → API Key）。

npx redash-mcp setup

ウィザードでは、Claude Desktop、Claude Code、Cursor、Gemini CLI、Codex CLIを任意に組み合わせて設定できます。

または、Node.js、Claude Desktop、MCP設定をまとめてインストールできます。

curl -fsSL https://raw.githubusercontent.com/seob717/redash-mcp/main/install.sh | bash

{
  "mcpServers": {
    "redash-mcp": {
      "command": "npx",
      "args": ["-y", "redash-mcp"],
      "env": {
        "REDASH_URL": "https://your-redash-instance.com",
        "REDASH_API_KEY": "your_api_key_here"
      }
    }
  }
}

claude mcp add --scope user redash-mcp \
  -e REDASH_URL=https://your-redash-instance.com \
  -e REDASH_API_KEY=your_api_key_here \
  -- npx -y redash-mcp

gemini mcp add -s user \
  -e REDASH_URL=https://your-redash-instance.com \
  -e REDASH_API_KEY=your_api_key_here \
  redash-mcp npx -y redash-mcp

codex mcp add redash-mcp \
  --env REDASH_URL=https://your-redash-instance.com \
  --env REDASH_API_KEY=your_api_key_here \
  -- npx -y redash-mcp

SQL セーフティガード

run_query で実行するアドホック SQL に適用されます。get_query_result で実行される保存済みクエリはチェックされないため、Redash のデータソースには読み取り専用の DB アカウントを使用してください。

• 常にブロック（REDASH_SAFETY_MODE=off の場合を除く）：DROP、TRUNCATE、ALTER TABLE、GRANT/REVOKE、WHERE のない DELETE/UPDATE
• 警告（warn）／ブロック（strict）：SELECT *、WHERE または LIMIT のないクエリ、PII 列へのアクセス
• 自動 LIMIT：REDASH_AUTO_LIMIT が設定されている場合、LIMIT N を追加します

詳細：docs/sql-safety-guard.md。クエリ結果はメモリにもキャッシュされます（下記の REDASH_MCP_CACHE_* を参照）。

環境変数

使用例

自然な言葉で尋ねるだけです。

• 「今月、新規ユーザーは何人登録しましたか？」 → smart_query がテーブルを選択 → run_query
• 「先週の新規ユーザーのうち、購入した人の割合は？」 → smart_query が JOIN を案内 → run_query
• 「1日の登録数が 100 件を下回ったときにアラートを作成して」 → create_alert

ダッシュボードを作成する：「月間売上のクエリを保存して、折れ線グラフにし、新しい Revenue ダッシュボードに追加して。」

1. create_query — 「Monthly Revenue」を保存
2. get_query_result — グラフの列を確認できるよう、一度実行
3. create_visualization — type: "line"、x_column: "month"、y_columns: ["revenue"]
4. create_dashboard — 「Revenue」を作成
5. add_widget — グラフを配置。ウィジェットを追加すると、下に積み重ねるか横に並べて配置できます

トラブルシューティング

開発

npm install
npm run dev     # run from source (tsx)
npm test        # vitest
npm run build   # typecheck + bundle to dist/

プライバシーポリシー

redash-mcp は、Redash インスタンスと直接通信するローカル MCP サーバーです。中継サーバーは使用しません。

ユーザーデータを第三者に販売または共有することはありません。

保持期間： 設定ファイルは削除されるまで ~/.redash-mcp/ に保持されます。クエリキャッシュはメモリ上に保存され、シャットダウン時に消去されます。スキーマキャッシュはメモリ上に保存され、有効期間（TTL）は10分です。

お問い合わせ： GitHub Issues からお問い合わせやセキュリティに関する報告をお寄せください。

免責事項

redash-mcp は、コミュニティが構築した非公式の連携機能であり、Redash との提携、Redash による承認または後援を受けていません。「Redash」はそれぞれの所有者の商標であり、ここでは互換性を説明する目的でのみ使用しています。本プロジェクトは、公開されている REST API を通じてのみ Redash と通信します。

ライセンス

MIT