Supabase MCP 服务器使用说明

项目简介

Supabase MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，它允许LLM客户端通过标准化的接口，安全、便捷地管理 Supabase 项目和组织。该服务器充当 LLM 与 Supabase Management API 之间的桥梁，将 Supabase 的管理功能以 MCP 工具的形式暴露给 LLM，实现通过自然语言指令控制 Supabase 资源。

主要功能点

项目管理：
- 列出所有项目
- 获取项目详情
- 创建新项目
- 删除项目
- 获取项目 API 密钥
组织管理：
- 列出所有组织
- 获取组织详情
- 创建新组织

安装步骤

环境准备：确保已安装 Node.js 和 npm (或 yarn)。
配置 MCP 服务器：将以下配置添加到您的 Claude Config JSON 文件中，以注册 Supabase MCP 服务器。

服务器配置

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "y",
        "@joshuarileydev/supabase-mcp-server"
      ],
      "env": {
        "SUPABASE_API_KEY": "YOUR_SUPABASE_API_KEY"
      }
    }
  }
}

配置参数说明：

'server name'：'supabase' (服务器名称，客户端配置中用于标识和调用该服务器)
'command': 'npx' (启动服务器的命令，这里使用 npx 运行 npm 包)
'args': '["y", "@joshuarileydev/supabase-mcp-server"]' (传递给 'command' 的参数，'y' 参数用于跳过 npm 包安装时的确认提示，'@joshuarileydev/supabase-mcp-server' 是要运行的 npm 包名称)
'env': (环境变量配置)
- 'SUPABASE_API_KEY': 'YOUR_SUPABASE_API_KEY' (Supabase API 密钥，请替换为您的真实密钥)

注意:

请务必将 'YOUR_SUPABASE_API_KEY' 替换为您在 Supabase 平台生成的 API 密钥。该密钥用于服务器认证并访问您的 Supabase 资源。
'npx' 会自动下载并运行 '@joshuarileydev/supabase-mcp-server' npm 包，无需手动安装。

基本使用方法

配置完成后，LLM 客户端 (如 Claude) 即可通过 MCP 协议与 Supabase MCP 服务器进行通信。客户端可以调用服务器提供的工具来管理 Supabase 资源。

示例工具调用 (非 Claude 客户端的实际操作，仅为理解工具功能)：

假设客户端希望列出所有 Supabase 项目，可以调用名为 'list_projects' 的工具。服务器会执行相应的操作，并返回项目列表作为工具执行结果。

类似的，客户端可以使用 'create_project', 'delete_project', 'get_organization' 等工具来执行其他 Supabase 管理操作。具体的工具名称和参数定义可以在服务器的 'ListTools' 响应中获取。

通过 Supabase MCP 服务器，LLM 应用能够以编程方式安全地与 Supabase 平台集成，实现更强大的自动化和智能化功能。

关键词