Redash MCPサーバー

Redash APIのMCPサーバーで、クエリの実行、結果の取得などの機能を提供します。

ツール

1. execute_query_and_wait

   • クエリを実行し、結果が利用可能になるまで待機します
   • 入力パラメータ:
     • data_source_id (数値): クエリを実行するデータソースのID
     • query (文字列): 実行するSQLクエリ
   • 戻り値: 利用可能になったクエリ結果

2. list_data_sources

   • 利用可能なすべてのデータソースを一覧表示します
   • 入力パラメータ: なし
   • 戻り値: データソースの配列

3. get_data_source

   • 特定のデータソースに関する詳細を取得します
   • 入力パラメータ:
     • data_source_id (数値): データソースのID
   • 戻り値: データソースの詳細情報

セットアップ

APIキー

Redash APIキーを取得してください。

1. Redashにログイン
2. 「Edit Profile」をクリック
3. APIキーをコピーする

環境変数

以下の環境変数が必要です:

• REDASH_API_KEY: RedashのAPIキー
• REDASH_BASE_URL: RedashのURL（例: https://redash.example.com）

git clone

このリポジトリをローカルにcloneしてください

npxで利用する場合

ビルドとnpxコマンドの登録を行ってください

npm install
npm run build
npm link

Claude DesktopまたはCursorのMCP設定に以下を追加してください

{
  "mcpServers": {
    "redash": {
      "command": "npx",
      "args": [
        "mcp-redash"
      ],
      "env": {
        "REDASH_API_KEY": "<YOUR_API_KEY>",
        "REDASH_BASE_URL": "https://redash.example.com"
      }
    }
  }
}

Dockerで利用する場合

ビルドを行ってください

docker build -t yuki9541134/mcp-redash .

Claude DesktopまたはCursorのMCP設定に以下を追加してください

{
  "mcpServers": {
    "redash": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "REDASH_API_KEY",
        "-e", "REDASH_BASE_URL",
        "yuki9541134/mcp-redash"
      ],
      "env": {
        "REDASH_API_KEY": "<YOUR_API_KEY>",
        "REDASH_BASE_URL": "https://redash.example.com"
      }
    }
  }
}

SSEモードで利用する場合

HTTPサーバーとして起動し、Server-Sent Events (SSE) を使用した通信を行うことも可能です。

開発時

npm run dev -- --sse

ビルド後

node dist/index.js --sse

SSEモードではHTTPサーバーがポート3000で起動します。エンドポイント：

• GET /sse - SSE接続の確立
• POST /messages - メッセージの送信