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 for Desktop 一起使用，请在 Claude for Desktop 配置文件中对其进行配置：

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

添加以下配置（根据需要编辑路径）：

可用工具

查询管理

• list-queries ：列出 Redash 中所有可用的查询
• get-query ：获取特定查询的详细信息
• create-query ：在 Redash 中创建一个新的查询
• update-query ：更新 Redash 中的现有查询
• archive-query ：存档（软删除）查询
• list-data-sources ：列出所有可用的数据源

查询执行

• execute-query ：执行查询并返回结果

仪表板管理

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

发展

以开发模式运行：

版本历史记录

• v1.1.0：添加查询管理功能（创建、更新、存档）
• v1.0.0：初始版本

执照

麻省理工学院