Redash

🚀 紅火MCPサーバー

モデルコンテキストプロトコル（MCP）サーバーで、紅火（Redash）をClaudeなどのAIアシスタントと統合するために使用します。

✨ 主な機能

• Redash APIを通じてRedashインスタンスに接続します。
• 利用可能なクエリとダッシュボードをリソースとして一覧表示します。
• クエリを実行し、結果を取得します。
• クエリの作成と管理（作成、更新、アーカイブ）を行います。
• クエリ作成に使用できるデータソースを一覧表示します。
• ダッシュボードの詳細情報とビジュアライゼーションを取得します。

📦 インストール

前提条件

• Node.js (v18以上)
• npmまたはyarn
• Redashインスタンスへのアクセス権
• Redash APIキー

環境変数

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

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

オプションの変数：

• REDASH_TIMEOUT：APIリクエストのタイムアウト時間（ミリ秒、デフォルトは30000）
• REDASH_MAX_RESULTS：返される最大結果数（デフォルトは1000）

インストール手順

1. このリポジトリをクローンします。

   git clone https://github.com/suthio/redash-mcp.git
   cd redash-mcp
   

2. 依存関係をインストールします。

   npm install
   

3. Redashの設定を含む.envファイルを作成します。

   REDASH_URL=https://your-redash-instance.com
   REDASH_API_KEY=your_api_key
   

4. プロジェクトをビルドします。

   npm run build
   

5. サーバーを起動します。

   npm start
   

💻 使用例

Claudeデスクトップとの連携

このMCPサーバーをClaudeデスクトップと統合するには、Claudeデスクトップの設定ファイルに以下の設定を追加します。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

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

利用可能なツール

クエリ管理

• list-queries：Redash内のすべての利用可能なクエリを一覧表示します。
• get-query：特定のクエリの詳細情報を取得します。
• create-query：Redash内に新しいクエリを作成します。
• update-query：既存のクエリを更新します。
• archive-query：クエリをアーカイブ（ソフト削除）します。
• list-data-sources：すべての利用可能なデータソースを一覧表示します。

クエリ実行

• execute-query：クエリを実行し、結果を返します。

ダッシュボード管理

• list-dashboards：すべての利用可能なダッシュボードを一覧表示します。
• get-dashboard：ダッシュボードの詳細情報とビジュアライゼーションを取得します。
• get-visualization：特定のビジュアライゼーションの詳細情報を取得します。

開発モードでの実行

npm run dev

📚 ドキュメント

バージョン履歴

• v1.1.0：クエリ管理機能（作成、更新、アーカイブ）を追加しました。
• v1.0.0：初期バージョン

📄 ライセンス

MIT