Redash MCP Server

社区

让 AI 助手连接 Redash，查询数据并管理仪表板。

分类: 数据库第 41 / 58
Stars: ★ 105 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 22.13+ · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 9 天前
工具数: 27

49FMRS · D

基于 README 的事实资料：这是一个非官方 Redash MCP 服务器，支持 stdio 和无状态 Streamable HTTP，覆盖查询、架构、仪表板和可视化管理；使用前应重点检查 API 密钥权限、数据暴露和 HTTP 网关认证。

最强项 · 文档质量 14/20 最弱项 · 安全与权限 7/20

可靠性

8/20

安全与权限

7/20

维护活跃度

7/20

文档质量

14/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: README 声称支持 stdio、HTTP、查询执行、仪表板和可视化管理，并提供测试命令，但服务器清单未缓存，未提供源文件、CI 工作流或测试覆盖证据，因此无法验证初始化握手、工具列表与实际行为的一致性。启动依赖 Node.js 22.13+、Corepack、pnpm、Redash URL 和 API key；错误可控性仅有文档层面的说明，故明显扣分。
安全与权限 7/20: API key 通过环境变量配置，Authorization 由服务器管理且不能被额外请求头覆盖；HTTP 默认绑定本机，并说明 Host/Origin 白名单不能替代认证，也警告不要直接暴露到互联网。这些是明确的安全边界。但 REDASH_EXTRA_HEADERS 会发送到每个 Redash 请求，HTTP 模式本身不认证 MCP 客户端，且 archive_query、delete_visualization 等有副作用操作未见确认或权限细分证据；缺少源文件使数据边界和凭据处理无法核验，因此大幅扣分。未发现提示中的明确红线证据。
维护活跃度 7/20: README 提供 v1.0.0 和 v1.1.0 版本历史，并列出测试和 Docker 镜像信息；仓库未归档且有 7 个开放 issue，但星标和 issue 数量不代表维护质量。没有提交频率、发布日期、issue 响应、依赖更新、安全响应渠道或可验证的 CI 证据；许可证元数据为 unknown，虽然 README 声称 MIT，存在证据不一致，故仅给较低中分。
文档质量 14/20: 文档覆盖安装、环境变量、stdio/Streamable HTTP、客户端配置、Docker、遥测、工具分类、参数、分页限制、BigQuery 特殊行为、健康检查和若干故障边界，且提供多种示例。扣分原因是服务器清单和源文件不可审查，工具真实参数与实现无法核验；缺少明确的成本/权限模型、系统化故障排查和安全响应说明，许可证信息也与元数据不一致。
安装易用性 13/20: README 给出 Node.js 22.13+、Corepack、pnpm、构建、启动和 Claude Desktop 配置步骤，也提供 Docker 与 HTTP 示例，主流客户端路径清楚。扣分原因是需要手动安装运行时、启用 Corepack、配置 Redash 实例和 API key；没有可验证的发布包、锁定版本、跨平台实测或 CI 证据，且 HTTP 部署还需要额外反向代理认证和白名单配置。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

已部署 Redash 并希望通过 MCP 使用其分析能力的团队。
需要查询执行、架构发现和仪表板管理的 MCP 客户端。
需要通过 OpenTelemetry 观察 MCP 与 Redash 请求的运维人员。

不适合谁

没有 Redash 实例或 API 密钥的用户。
需要直接连接数据库而不经过 Redash API 的场景。
希望将 HTTP 监听器直接暴露到互联网的场景。

所需权限

需要访问 Redash 实例。
需要 REDASH_API_KEY；服务器以 Key 方案管理 Authorization 请求头。
根据使用的工具，API 密钥可能允许读取、创建、更新、归档查询，以及管理仪表板和可视化。

风险与副作用

查询结果、SQL、描述、可视化和 CSV 可能包含敏感业务数据。
启用 OTel 消息内容采集后，查询参数、结果和错误内容可能发送到遥测后端。
HTTP 模式的 Host 和 Origin 白名单不负责 MCP 客户端身份认证；应在认证网关或反向代理后运行。
归档查询是软删除，更新、删除可视化和布局修改仍会改变 Redash 状态。

安装接入

准备工作

运行环境：Node.js 22.13+ · Docker

REDASH_URL 必填你的 Redash 实例地址，例如 https://redash.example.com。

REDASH_API_KEY 必填密钥你的 Redash API 密钥，从 Redash 用户设置中获取，服务器以 Key <token> 形式发送 Authorization 头。

其他可选配置项（19 个）

REDASH_TIMEOUT 可选 API 请求超时毫秒数，默认 30000。

REDASH_MAX_RESULTS 可选返回结果的最大条数，默认 1000。

REDASH_EXTRA_HEADERS 可选附加到每个 Redash 请求的额外 HTTP 头，支持 JSON 对象串或分号/逗号分隔的 key=value 列表。

REDASH_SOCKS_PROXY 可选路由请求的 SOCKS 代理地址，如 socks5h://localhost:1080。

MCP_TRANSPORT 可选 MCP 传输方式：stdio、http 或 streamable-http，默认 stdio。

MCP_HTTP_HOST 可选 Streamable HTTP 监听主机，默认 127.0.0.1。

MCP_HTTP_PORT 可选 Streamable HTTP 监听端口，默认 3000。

MCP_HTTP_PATH 可选 Streamable HTTP 端点路径，默认 /mcp。

MCP_HTTP_ALLOWED_HOSTS 可选 HTTP 模式的 Host 头允许列表，逗号分隔主机名。

MCP_HTTP_ALLOWED_ORIGINS 可选 HTTP 模式的浏览器 Origin 允许列表，同时控制 CORS。

OTEL_EXPORTER_OTLP_ENDPOINT 可选 OTLP 导出端点，用于 traces/metrics/logs。

OTEL_METRICS_EXPORTER 可选指标导出器，如 otlp、prometheus 或 none。

OTEL_EXPORTER_OTLP_PROTOCOL 可选 OTLP 协议：grpc、http/protobuf 或 http/。

OTEL_TRACES_EXPORTER 可选显式指定 traces 导出器，none 表示禁用。

OTEL_LOGS_EXPORTER 可选显式指定 logs 导出器，none 表示禁用。

OTEL_EXPORTER_PROMETHEUS_HOST 可选 Prometheus 独立监听主机。

OTEL_EXPORTER_PROMETHEUS_PORT 可选 Prometheus 独立监听端口。

OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT 可选设为 true 时在遥测中记录工具参数与结果内容（含 SQL 与查询结果），默认省略。

OTEL_SDK_DISABLED 可选设为 true 禁用所有遥测信号。

准备 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"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "redash": {
      "command": "npx",
      "args": [
        "-y",
        "@suthio/redash-mcp"
      ],
      "env": {
        "REDASH_API_KEY": "your-api-key",
        "REDASH_URL": "https://your-redash-instance.com"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add redash -e REDASH_API_KEY=your-api-key -e REDASH_URL=https://your-redash-instance.com -- npx -y @suthio/redash-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中确认出现 list_queries、execute_query 等 Redash 工具，然后调用 list_queries 验证能返回该 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 里所有的查询
执行查询 42 并把结果导出为 CSV
查看数据源 7 中 analytics_public 数据集的表结构，每页 10 张表
把仪表盘上 3 号小组件移动到第 0 行第 4 列

工具能力 27

list_queries 只读

列出 Redash 中可用的查询。

get_query 只读

获取指定查询的详细信息。

create_query 写入

在 Redash 中创建查询。

update_query 写入

更新现有查询。

get_query_parameters 只读

查看保存查询的参数定义。

update_query_parameters 写入

更新保存查询的参数定义。

archive_query 破坏性

归档查询，即软删除查询。

list_data_sources 只读

列出可用的数据源。

展开其余 19 个工具

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 破坏性

删除可视化。

使用场景

让 AI 助手发现并执行 Redash 查询。

执行带类型参数和保存默认值的参数化查询。

探索数据源架构并辅助编写查询。

创建和维护查询、仪表板布局及可视化。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Redash MCP Server 通过 Redash API 将查询、数据源、架构、仪表板和可视化功能提供给 MCP 客户端。它支持执行即时查询和保存的参数化查询，创建、更新和归档查询，以及检查和修改仪表板布局、参数映射和图表选项。