使用说明
redash mcp
用于Redash API集成的MCP(模型上下文协议)服务器。
需求
- Python 3.10+
- 紫外线
安装
# Clone the repository
git clone https://github.com/eiji-hb/redash-mcp.git
cd redash-mcp
# Install dependencies
uv sync
配置
设置以下环境变量:
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
REDASH_URL |
是 | - | Redash实例URL |
REDASH_API_KEY |
是 | - | Redash API密钥 |
REDASH_TIMEOUT |
否 | 30000 | 请求超时(毫秒) |
用法
使用克劳德桌面
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"redash": {
"command": "uv",
"args": ["--directory", "/path/to/redash-mcp", "run", "redash-mcp"],
"env": {
"REDASH_URL": "https://your-redash-instance.example.com",
"REDASH_API_KEY": "your-api-key-here"
}
}
}
}
备注:必须在中设置环境变量
env配置的一部分。这.env从Claude Desktop运行时,文件未加载。
独立
# Set environment variables
export REDASH_URL=https://your-redash-instance.example.com
export REDASH_API_KEY=your-api-key-here
# Or create a .env file
uv run redash-mcp
可用工具
查询
list_queries-在Redash中列出所有已保存的SQL查询get_query-按ID获取特定查询的详细信息create_query-创建新的SQL查询update_query-更新现有查询archive_query-存档(软删除)查询get_query_result-获取查询的缓存结果(仅限非参数化)execute_query-执行查询(支持参数化查询和缓存控制)get_query_result_by_id-按结果ID获取查询结果
工作
get_job-获取作业状态(1=待处理,2=已开始,3=成功,4=失败,5=取消)
仪表盘
list_dashboards-在Redash中列出所有仪表板get_dashboard-按指示牌拿一个仪表盘create_dashboard-创建新仪表板update_dashboard-更新现有仪表板archive_dashboard-存档(软删除)仪表板
许可证
麻省理工学院
