Redash MCP 服务器

用于将 Redash 与像 Claude 这样的AI助手集成的模型上下文协议（MCP）服务器。

<a href="https://glama.ai/mcp/servers/j9bl90s3tw"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=845300022,1519329149&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Redash Server MCP 服务器" /> </a>

功能

• 通过 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：更新 Redash 中现有的查询
• archive-query：归档（软删除）查询
• list-data-sources：列出所有可用的数据源

查询执行

• execute-query：执行查询并返回结果
• execute-adhoc-query：执行临时查询而不将其保存到 Redash

仪表板管理

• list-dashboards：列出所有可用的仪表板
• get-dashboard：获取仪表板的详细信息和可视化内容
• get-visualization：获取特定可视化的详细信息

可视化管理

• create-visualization：为查询创建新的可视化
• update-visualization：更新现有的可视化
• delete-visualization：删除可视化

开发

在开发模式下运行：

npm run dev

版本历史

• v1.1.0：添加了查询管理功能（创建、更新、归档）
• v1.0.0：初始发布

许可证

MIT