Query MCP

社区

通过聊天安全管理 Supabase。

分类: 数据库第 38 / 58
Stars: ★ 833 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.12+
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 14 个月前 ⚠
工具数: 13

50FMRS · D

这是一个功能覆盖较广、带统一安全控制的 Supabase 数据库 MCP 服务器，支持 SQL、迁移、Management API、Auth Admin 和日志访问。其主要限制是仅支持 Supabase.com 托管项目和本地开发，不支持自托管或自定义连接字符串；同时项目已停止积极维护。

最强项 · 文档质量 14/20 最弱项 · 维护活跃度 5/20

可靠性

8/20

安全与权限

12/20

维护活跃度

5/20

文档质量

14/20

安装易用性

11/20

查看各项评分依据

可靠性 8/20: README 描述了 stdio 启动、工具集合、事务处理和安全流程，但没有提供可审查的服务器清单、源代码、提交测试或实际 CI 测试证据。由于只能静态审查，无法验证 MCP 初始化、工具列表与实现是否一致，也无法确认依赖和异常路径；因此明显低于高可靠性评分。
安全与权限 12/20: 证据显示支持环境变量凭据、默认安全模式、SQL 风险分级、危险操作二次确认，以及将删除项目等极端操作标记为禁止。扣分原因是服务器清单和源代码缺失，无法验证凭据是否会泄露、任意 Management API 请求的实际边界、日志数据范围、权限最小化和确认机制是否真正强制执行；同时 Auth Admin 和数据库写入能力带来较大副作用。
维护活跃度 5/20: 项目明确说明作者已不再积极维护，并建议改用 Supabase 官方服务器。虽然仓库未归档且采用 Apache-2.0 许可证，也提供了版本变更记录，但没有当前维护承诺、依赖更新证据、响应流程或安全公告渠道；因此维护活跃度较低。
文档质量 14/20: README 覆盖安装、运行时要求、环境变量、区域、连接方式、多个客户端配置、功能、风险等级、限制和故障排查，证据较完整。扣分原因是工具参数和返回契约不够系统，服务器清单缺失，部分安装/配置说明依赖外部服务与未验证的包行为，且没有成本、数据保留或安全审查细节。
安装易用性 11/20: 文档给出了 pipx、uv 和源码安装路径，并提供 Cursor、Windsurf、Claude Desktop 与 Cline 的配置示例及平台路径说明。扣分原因是要求 Python 3.12+、额外的 QUERY_API_KEY、Supabase 凭据和正确区域，部分客户端需要手动查找绝对路径；缺少可验证的 CI、测试或实际启动证据，因此流程仍较脆弱。

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

查看 FMRS 评分方法 →

选型与风险

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

适合谁

使用 Cursor、Windsurf、Cline 或 Claude Desktop 的 Supabase 开发者。
需要 SQL、项目管理、认证管理和日志访问统一入口的团队。
接受本地 Supabase 或 Supabase.com 托管项目限制的开发环境。

不适合谁

需要自托管 Supabase 支持的用户。
需要自定义数据库连接字符串或 Session Pooling 的用户。
需要持续维护、官方支持或最新功能的生产团队。
仅使用本地 Supabase 却需要 Management API 或 Auth Admin 功能的用户。

所需权限

需要数据库项目引用和数据库密码。
所有操作都需要 thequery.dev 提供的 QUERY_API_KEY。
Management API 操作需要 Supabase 个人访问令牌。
Auth Admin 操作需要 Supabase service role key。
数据库连接使用事务池；远程项目必须提供正确的 Supabase 区域。

风险与副作用

安全模式默认只允许低风险只读操作。
写操作需要启用不安全模式；高风险操作还需要明确确认。
极高风险操作（例如删除项目）会被阻止。
数据库修改会自动生成迁移脚本，但错误的 SQL 或高权限凭据仍可能造成数据损失。
service role key 和数据库密码具有较高权限，应妥善保护。
项目已不再积极维护，README 建议关注 Supabase 官方 MCP 服务器。

安装接入

准备工作

运行环境：Python 3.12+

QUERY_API_KEY 必填密钥在 thequery.dev 免费获取的 API 密钥，v0.4 起所有操作必需。

SUPABASE_PROJECT_REF 必填 Supabase 项目引用 ID（或本地 host:port），可在项目 URL 中找到。

SUPABASE_DB_PASSWORD 必填密钥数据库密码，项目创建时设置或在 Project Settings → Database 查看。

SUPABASE_ACCESS_TOKEN 可选密钥 Supabase 个人访问令牌，用于 Management API，在 dashboard/account/tokens 生成，仅远程项目需要。

SUPABASE_SERVICE_ROLE_KEY 可选密钥 Service role 密钥，用于 Auth Admin SDK，在 Project Settings → API 中获取，仅 Auth Admin 功能需要。

其他可选配置项（1 个）

SUPABASE_REGION 可选项目所在的 AWS 区域，默认 us-east-1，区域不匹配会导致 'Tenant or user not found' 错误。

需要 Python 3.12+。可使用 pipx install supabase-mcp-server 或 uv pip install supabase-mcp-server 安装，也可从仓库根目录以可编辑模式安装。配置 QUERY_API_KEY、SUPABASE_PROJECT_REF 和 SUPABASE_DB_PASSWORD；远程项目还应配置正确的 SUPABASE_REGION。Management API 需要 SUPABASE_ACCESS_TOKEN，Auth Admin SDK 需要 SUPABASE_SERVICE_ROLE_KEY。然后在 MCP 客户端中配置服务器命令；Claude Desktop、Cline 和类似客户端通常需要可执行文件的绝对路径。

.cursor/mcp.json

{"mcpServers":{"supabase":{"command":"/full/path/to/supabase-mcp-server","env":{"QUERY_API_KEY":"your-api-key","SUPABASE_PROJECT_REF":"your-project-ref","SUPABASE_DB_PASSWORD":"your-db-password","SUPABASE_REGION":"us-east-1","SUPABASE_ACCESS_TOKEN":"your-access-token","SUPABASE_SERVICE_ROLE_KEY":"your-service-role-key"}}}}

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

.vscode/mcp.json

{
  "servers": {
    "supabase": {
      "command": "/full/path/to/supabase-mcp-server",
      "env": {
        "QUERY_API_KEY": "your-api-key",
        "SUPABASE_PROJECT_REF": "your-project-ref",
        "SUPABASE_DB_PASSWORD": "your-db-password",
        "SUPABASE_REGION": "us-east-1",
        "SUPABASE_ACCESS_TOKEN": "your-access-token",
        "SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key"
      }
    }
  }
}

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

Terminal

claude mcp add supabase -e QUERY_API_KEY=your-api-key -e SUPABASE_PROJECT_REF=your-project-ref -e SUPABASE_DB_PASSWORD=your-db-password -e SUPABASE_REGION=us-east-1 -e SUPABASE_ACCESS_TOKEN=your-access-token -e SUPABASE_SERVICE_ROLE_KEY=your-service-role-key -- /full/path/to/supabase-mcp-server

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

生成并校验客户端配置

验证是否装好

运行 which supabase-mcp-server（Windows 用 where）找到可执行文件路径并在客户端配置，连接成功后客户端应显示绿色指示并显示服务器暴露的工具数量（如 get_schemas、execute_postgresql 等）。也可用 get_schemas 工具测试数据库连接是否正常。

常见排障

直接运行 supabase-mcp-server，检查安装和配置是否正常。
如果出现找不到工具或 spawn ENOENT，改用可执行文件的完整绝对路径。
检查环境变量或全局配置文件是否包含正确的项目引用、数据库密码和 API key。
远程项目出现 Tenant or user not found 时，核对 SUPABASE_REGION。
查看 macOS/Linux 的 ~/.local/share/supabase-mcp/mcp_server.log，或 Windows 对应用户目录下的日志文件。
确认远程项目使用事务池连接，而不是 Session Pooling。

试试这样问

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

列出数据库中所有 schema 及其表数量
查看 users 表的详细结构，包括列和主键
创建一个测试用户，邮箱为 [email protected]
查看最近的 auth 认证日志

工具能力 13

get_schemas 只读

列出数据库架构及其大小和表数量。

get_tables 只读

列出表、外部表和视图，并提供元数据。

get_table_schema 只读

获取表的列、键和关系等详细结构。

execute_postgresql 写入

执行 PostgreSQL 语句，并进行风险评估。

confirm_destructive_operation 破坏性

在明确确认后执行高风险数据库操作。

retrieve_migrations 只读

按筛选条件和分页选项获取迁移记录。

live_dangerously 写入

在安全模式和不安全模式之间切换。

send_management_api_request 写入

向 Supabase Management API 发送请求，并自动注入项目引用。

展开其余 5 个工具

get_management_api_spec 只读

获取包含安全信息、参数要求和响应格式的 Management API 规范。

get_management_api_safety_rules 只读

获取安全规则及其人类可读说明。

get_auth_admin_methods_spec 只读

获取可用 Supabase Auth Admin 方法的文档。

call_auth_admin_method 写入

调用 Supabase Auth Admin 方法并处理参数。

retrieve_logs 只读

访问 Supabase 各服务的日志和分析数据。

使用场景

通过自然语言查询和修改 Supabase PostgreSQL 数据库。

查看数据库架构、表结构和自动生成的迁移记录。

管理远程 Supabase 项目并访问 Supabase 服务日志。

创建、列出、更新或删除测试用户，以及生成认证链接。

支持客户端

Cursor

Windsurf

Cline

Claude Desktop

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

详细介绍

Query MCP 是一个开源 Supabase MCP 服务器，可通过 stdio 让支持 MCP 的客户端执行 SQL、管理数据库架构、调用 Supabase Management API、使用 Auth Admin SDK，以及访问日志和分析数据。项目 README 表明该服务器已不再积极维护，因为 Supabase 已发布官方 MCP 服务器。