Redash

🚀 紅火 MCP 服務器

紅火 MCP 服務器基於模型上下文協議（MCP）構建，其核心價值在於搭建起紅火（Redash）與人工智能助手（如 Claude）之間的橋樑，實現兩者的高效集成，為數據查詢和管理提供便利。

🚀 快速開始

紅火 MCP 服務器可將 Redash 與人工智能助手集成。要使用該服務器，需先完成安裝和配置，之後就能借助它執行各類查詢、管理資源等操作。

✨ 主要特性

• 🔗 通過 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 許可證。