StackQL MCP Server

官方

用 SQL 查询和配置云基础设施。

分类: 其他
Stars: ★ 1.1k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · Python · Docker · 预编译二进制
凭据: 可选 API Key
许可证: MIT
最近提交: 9 天前

55FMRS · C

来源显示该服务器由 StackQL 项目维护，采用 stdio 传输，并提供 npm、PyPI、Docker、GitHub Actions 和 .mcpb 分发方式。它适合云与 SaaS 资源的 SQL 查询和配置；工具名称、具体认证范围及客户端完整兼容性未在来源中列出。

最强项 · 安装易用性 13/20 最弱项 · 安全与权限 8/20

可靠性

9/20

安全与权限

8/20

维护活跃度

13/20

文档质量

12/20

安装易用性

13/20

查看各项评分依据

可靠性 9/20: 清单明确提供了 stdio 传输、多平台包、版本和校验哈希，README 也给出启动方式，因此基本握手路径是可信的。扣分原因是仅有静态材料，没有提交的 MCP 关键路径测试、CI 执行证据、工具列表或错误处理证据，无法验证声明工具与实际行为一致；按静态校准不超过 12 分。
安全与权限 8/20: 材料显示该服务器可访问并配置云和 SaaS 资源，涉及外部网络、凭据和潜在基础设施副作用；README 仅明确 GitHub Actions 默认 read_only，未证明通用 MCP 模式的最小权限、工具级范围、危险操作确认、凭据边界或数据流控制。没有材料证明存在红线风险，因此未判定为红线，但因安全控制证据不足而扣分。
维护活跃度 13/20: 仓库未归档，提供 MIT 许可证、明确仓库归属、当前版本和多个发布渠道，说明存在维护和更新路径。扣分原因是提示材料没有提交频率、维护者响应记录、依赖更新策略、漏洞披露或安全响应渠道；开放 issue 数量也不能证明维护质量。
文档质量 12/20: README 覆盖项目用途、MCP 启动、npm/PyPI/Docker/.mcpb/GitHub Actions 安装、客户端配置、认证占位符、示例查询和只读模式。扣分原因是没有具体工具参数与能力清单、权限模型、限制、成本影响、兼容性细节或故障排查证据，且相关内容主要通过外部文档链接指引。
安装易用性 13/20: 提供 npm、PyPI、Docker、.mcpb 和 GitHub Actions 等多种安装路径，并给出主流 MCP 客户端配置示例及 Windows、macOS、Linux 支持信息。扣分原因是认证准备、运行时前置条件、版本兼容性和连接验证步骤不完整；部分路径依赖外部工具或手动下载，静态材料也没有可验证执行证据，因此不超过 15 分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

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

适合谁

需要统一 SQL 接口管理多个云或 SaaS 提供商的团队
希望让 AI 代理以结构化方式访问云资源的用户
云运维、安全、FinOps 和基础设施即代码场景

不适合谁

只需要本地文件或浏览器自动化的用户
不希望授予云或 SaaS API 访问权限的环境
需要已在来源中明确列出的独立 MCP 工具清单的用户

所需权限

需要通过 --auth 或客户端配置提供相应的云或 SaaS 提供商认证信息
实际权限取决于所使用的提供商凭证及操作；服务器支持查询和资源配置
GitHub Actions 默认使用 read_only 模式，适合 CI 场景

风险与副作用

配置或修改资源可能产生真实的基础设施变更
凭证权限过大可能扩大云或 SaaS 资源的影响范围
AI 代理生成的 SQL 或 API 操作应在执行前审查
跨云操作可能带来成本、合规和安全影响

安装接入

准备工作

运行环境：Node.js · Python · Docker · 预编译二进制

使用支持 MCP 的客户端，将 npm 配置中的 command 设置为 npx，并将 args 设置为 -y 和 @stackql/mcp-server。也可使用 PyPI、Docker、GitHub Actions 或平台对应的 .mcpb 安装包。详细客户端配置、认证和服务器模式请参阅 StackQL 文档。

.cursor/mcp.json

{"mcpServers":{"stackql":{"command":"npx","args":["-y","@stackql/mcp-server"]}}}

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

.vscode/mcp.json

{
  "servers": {
    "stackql": {
      "command": "npx",
      "args": [
        "-y",
        "@stackql/mcp-server"
      ]
    }
  }
}

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

Terminal

claude mcp add stackql -- npx -y @stackql/mcp-server

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

生成并校验客户端配置

验证是否装好

在 MCP 客户端配置中添加 stackql 服务器（如 npx -y @stackql/mcp-server），启动客户端后确认 stackql 服务器已连接，并尝试运行一条简单的 SQL 查询（例如列出某个 provider 的资源）以验证连通性。

常见排障

确认客户端支持 MCP 的 stdio 传输
确认 npx、PyPI、Docker 或对应平台安装包可用
检查认证参数和提供商凭证权限
先在 read_only 模式或查询操作中验证连接，再执行配置操作
检查 StackQL 文档中的客户端配置、认证和服务器模式说明

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出 us-east-1 区域的所有 AWS EC2 实例及其状态
查询我所有云账户中正在运行的虚拟机的数量和规格
使用 SQL 查询 GitHub 仓库的 Star 数和贡献者信息
通过 StackQL 查询 Azure 订阅下的存储账户清单

使用场景

使用 SQL 查询云和 SaaS 资源

跨云资产管理与安全审计

通过 MCP 让 AI 代理查询或配置基础设施

使用 GitHub Actions 自动化基础设施配置与合规检查

支持客户端

Claude部分支持

VS Code部分支持

Cursor部分支持

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

详细介绍

StackQL MCP Server 是由 StackQL 提供的 SQL 原生云基础设施查询与配置引擎，通过 MCP 服务访问 40 多个云和 SaaS 提供商。它将 SQL 语句转换为提供商 API 请求，用于查询、创建、修改和操作资源。