MCP 服务器

PostgREST

这是一个用于 PostgREST 的 MCP 服务器。它允许 LLM 通过 PostgREST 对 Postgres 数据库执行数据库查询和操作。此服务器可与 Supabase 项目（使用 PostgREST）和独立的 PostgREST 服务器一起使用。

README

Supabase MCP 服务器

将您的 Supabase 项目连接到 Cursor、Claude、Windsurf 和其他 AI 助手。

supabase-mcp-demo

模型上下文协议 (MCP) 标准化了大型语言模型 (LLM) 与 Supabase 等外部服务通信的方式。它将 AI 助手直接与您的 Supabase 项目连接，并允许它们执行管理表、获取配置和查询数据等任务。请参阅工具的完整列表。

前提条件

您需要在您的机器上安装 Node.js。您可以通过运行以下命令来检查：

node -v

如果您没有安装 Node.js，您可以从 nodejs.org 下载。

设置

1. 个人访问令牌 (PAT)

首先，转到您的 Supabase 设置并创建一个个人访问令牌。给它一个描述其用途的名称，例如“Cursor MCP Server”。

这将用于使用您的 Supabase 帐户对 MCP 服务器进行身份验证。务必复制令牌，因为您将无法再次看到它。

2. 配置 MCP 客户端

接下来，配置您的 MCP 客户端（例如 Cursor）以使用此服务器。大多数 MCP 客户端将配置存储为以下格式的 JSON：

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--access-token",
        "<personal-access-token>"
      ]
    }
  }
}

将 <personal-access-token> 替换为您在步骤 1 中创建的令牌。如果您使用的是 Windows，则需要为此命令添加前缀。

如果您的 MCP 客户端不接受 JSON，则直接 CLI 命令是：

npx -y @supabase/mcp-server-supabase@latest --access-token=<personal-access-token>

注意：不要直接运行此命令 - 这是为了让您的 MCP 客户端执行以启动服务器。 npx 会自动从 npm 下载最新版本的 MCP 服务器，并在单个命令中运行它。

Windows

在 Windows 上，您需要使用 cmd /c 为命令添加前缀：

{
  "mcpServers": {
    "supabase": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--access-token",
        "<personal-access-token>"
      ]
    }
  }
}

或者，如果您在 WSL 中运行 Node.js，则使用 wsl：

{
  "mcpServers": {
    "supabase": {
      "command": "wsl",
      "args": [
        "npx",
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--access-token",
        "<personal-access-token>"
      ]
    }
  }
}

确保 Node.js 在您的系统 PATH 环境变量中可用。如果您在 Windows 上本地运行 Node.js，则可以通过在终端中运行以下命令来设置它。

获取 npm 的路径：
```
npm config get prefix
```
将目录添加到您的 PATH：
```
setx PATH "%PATH%;<path-to-dir>"
```
重新启动您的 MCP 客户端。

工具

注意： 此服务器是 1.0 之前的版本，因此预计版本之间会有一些重大更改。由于 LLM 会自动适应可用的工具，因此这不应影响大多数用户。

以下 Supabase 工具可供 LLM 使用：

项目管理

list_projects：列出用户的所有 Supabase 项目。
get_project：获取项目的详细信息。
create_project：创建一个新的 Supabase 项目。
pause_project：暂停一个项目。
restore_project：恢复一个项目。
list_organizations：列出用户所属的所有组织。
get_organization：获取组织的详细信息。

数据库操作

list_tables：列出指定模式中的所有表。
list_extensions：列出数据库中的所有扩展。
list_migrations：列出数据库中的所有迁移。
apply_migration：将 SQL 迁移应用到数据库。传递给此工具的 SQL 将在数据库中进行跟踪，因此 LLM 应该将其用于 DDL 操作（模式更改）。
execute_sql：在数据库中执行原始 SQL。 LLM 应该将其用于不更改模式的常规查询。
get_logs：按服务类型（api、postgres、边缘函数、auth、storage、realtime）获取 Supabase 项目的日志。 LLM 可以使用它来帮助调试和监控服务性能。