适合谁
- 已部署 Redash 并希望通过 MCP 使用其分析能力的团队。
- 需要查询执行、架构发现和仪表板管理的 MCP 客户端。
- 需要通过 OpenTelemetry 观察 MCP 与 Redash 请求的运维人员。
R
49FMRS · D
基于 README 的事实资料：这是一个非官方 Redash MCP 服务器，支持 stdio 和无状态 Streamable HTTP，覆盖查询、架构、仪表板和可视化管理；使用前应重点检查 API 密钥权限、数据暴露和 HTTP 网关认证。
Redash MCP Server 通过 Redash API 将查询、数据源、架构、仪表板和可视化功能提供给 MCP 客户端。它支持执行即时查询和保存的参数化查询，创建、更新和归档查询，以及检查和修改仪表板布局、参数映射和图表选项。
工具能力
list_queries
列出 Redash 中可用的查询。
get_query
获取指定查询的详细信息。
create_query
在 Redash 中创建查询。
update_query
更新现有查询。
get_query_parameters
查看保存查询的参数定义。
update_query_parameters
更新保存查询的参数定义。
archive_query
归档查询，即软删除查询。
list_data_sources
列出可用的数据源。
execute_query
执行查询并返回结果，可选使用 maxAge。
execute_parameterized_query
使用类型感知的值转换、保存的默认值和可选 maxAge 执行保存的参数化查询。
execute_adhoc_query
执行不保存到 Redash 的即时查询。
get_query_results_csv
获取查询结果的 CSV 格式，可选刷新最新数据。
get_schema
分页获取数据源的表和列架构。
list_dashboards
列出可用的仪表板。
get_dashboard
获取仪表板详情和可视化内容。
get_dashboard_layout
查看仪表板组件的位置、尺寸和可见性。
get_visualization
获取指定可视化的详情。
get_dashboard_parameters
查看仪表板参数值和组件映射。
update_dashboard_parameters
更新仪表板参数值和顺序。
update_dashboard_layout
在一次调用中移动或调整多个组件的大小。
update_widget_layout
移动或调整单个组件的大小。
get_widget_parameter_mappings
查看组件的参数映射。
update_widget_parameter_mappings
更新组件的参数映射。
create_visualization
为查询创建新的可视化。
update_visualization
更新现有可视化。
update_chart_visualization
更新图表特定选项，例如系列类型、列映射、系列选项、图例和坐标轴设置。
delete_visualization
删除可视化。
安装接入
准备 Node.js 22.13 或更高版本、Corepack、Redash 实例访问权限和 Redash API 密钥。使用 npx 配置 Claude Desktop，设置 REDASH_URL 和 REDASH_API_KEY。也可以克隆仓库后运行 corepack enable、pnpm install、pnpm run build 和 pnpm start。默认使用 stdio；可通过 MCP_TRANSPORT=http 启用无状态 Streamable HTTP。
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"}}}}
选型与风险
不适合谁
- 没有 Redash 实例或 API 密钥的用户。
- 需要直接连接数据库而不经过 Redash API 的场景。
- 希望将 HTTP 监听器直接暴露到互联网的场景。
所需权限
- 需要访问 Redash 实例。
- 需要 REDASH_API_KEY；服务器以 Key 方案管理 Authorization 请求头。
- 根据使用的工具，API 密钥可能允许读取、创建、更新、归档查询，以及管理仪表板和可视化。
风险与副作用
- 查询结果、SQL、描述、可视化和 CSV 可能包含敏感业务数据。
- 启用 OTel 消息内容采集后，查询参数、结果和错误内容可能发送到遥测后端。
- HTTP 模式的 Host 和 Origin 白名单不负责 MCP 客户端身份认证；应在认证网关或反向代理后运行。
- 归档查询是软删除，更新、删除可视化和布局修改仍会改变 Redash 状态。
常见排障
- 确认 REDASH_URL 和 REDASH_API_KEY 已设置且 API 密钥可访问目标 Redash。
- 确认 Node.js 至少为 22.13，并启用 Corepack。
- stdio 模式下确保日志写入 stderr，避免将其误认为 MCP 输出。
- HTTP 模式默认监听 127.0.0.1:3000/mcp；检查 MCP_TRANSPORT、主机、端口、路径及 Host/Origin 白名单。
- HTTP 模式不提供独立 GET SSE 流；使用 POST /mcp。
- 架构结果较大时使用 get_schema 的 page、pageSize、search 和 nextPage 分页。
使用场景
让 AI 助手发现并执行 Redash 查询。
执行带类型参数和保存默认值的参数化查询。
探索数据源架构并辅助编写查询。
创建和维护查询、仪表板布局及可视化。
支持客户端
Claude Desktop完整支持