基本能力
产品定位
Redash MCP Server 是一个中间件,用于在 Redash 数据可视化平台和 AI 助手之间建立桥梁,实现数据的查询和管理。
核心功能
- 通过 Redash API 连接到 Redash 实例
- 列出可用的查询和仪表板作为资源
- 执行查询并获取结果
- 创建和管理查询(创建、更新、归档)
- 列出用于查询创建的数据源
- 获取仪表板详情和可视化
适用场景
- 在 AI 助手中直接查询 Redash 数据
- 自动化 Redash 查询和仪表板管理
- 集成 Redash 功能到其他应用程序中
工具列表
查询管理
list-queries
: 列出 Redash 中所有可用查询get-query
: 获取特定查询的详细信息create-query
: 在 Redash 中创建新查询update-query
: 更新现有查询archive-query
: 归档(软删除)查询list-data-sources
: 列出所有可用数据源
查询执行
execute-query
: 执行查询并返回结果
仪表板管理
list-dashboards
: 列出所有可用仪表板get-dashboard
: 获取仪表板详情和可视化get-visualization
: 获取特定可视化的详细信息
常见问题解答
- 需要哪些环境变量?
- 必须变量:
REDASH_URL
和REDASH_API_KEY
-
可选变量:
REDASH_TIMEOUT
和REDASH_MAX_RESULTS
-
如何与 Claude for Desktop 集成?
- 在 Claude for Desktop 配置文件中添加 MCP 服务器配置
使用教程
使用依赖
- Node.js (v18 或更高版本)
- npm 或 yarn
- 访问 Redash 实例
- Redash API 密钥
安装教程
-
克隆仓库:
bash
git clone https://github.com/suthio/redash-mcp.git
cd redash-mcp -
安装依赖:
bash
npm install -
创建
.env
文件:
REDASH_URL=https://your-redash-instance.com
REDASH_API_KEY=your_api_key -
构建项目:
bash
npm run build -
启动服务器:
bash
npm start
调试方式
- 开发模式运行:
bash
npm run dev - 检查环境变量是否设置正确
- 验证 Redash API 密钥和 URL 是否正确