Redash API集成服务

Redash MCP服务器,用于集成Redash API,提供查询、仪表板管理和作业状态获取等功能。

  • by eiji-hb
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 eiji-hb/redash-mcp

使用说明

redash mcp

用于Redash API集成的MCP(模型上下文协议)服务器。

日语版在这里

需求

安装

# 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 -存档(软删除)仪表板

许可证

麻省理工学院