Supabase MCP Server
2025.02.25
38
JavaScript数据库管理后端服务数据库
Supabase MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，提供与 Supabase 数据库、存储和边缘函数交互的全面工具。该服务器实现了 Supabase 服务与 MCP 兼容应用之间的无缝集成，主要功能包括数据库操作、存储管理、边缘函数调用、项目和组织管理、用户认证与管理以及基于角色的访问控制。
View on GitHub
Overview
基本能力
产品定位
Supabase MCP Server 是一个中间件服务，旨在桥接 MCP 客户端与 Supabase 服务套件，提供高效的数据管理和服务集成能力。
核心功能
- 数据库操作：支持丰富的查询能力，包括创建、读取、更新和删除记录
- 存储管理：文件上传、下载和管理功能
- 边缘函数：调用 Supabase 边缘函数
- 项目管理：项目和组织管理功能
- 用户管理：用户认证、创建、更新和删除
- 访问控制：基于角色的权限管理
适用场景
- 需要与 Supabase 数据库集成的应用开发
- 需要管理 Supabase 存储的文件上传下载功能
- 需要调用 Supabase 边缘函数的应用
- 需要用户认证和权限管理的系统
工具列表
- 数据库操作工具：
create_record: 创建新记录read_records: 读取记录update_record: 更新记录delete_record: 删除记录- 存储操作工具：
upload_file: 上传文件download_file: 下载文件- 边缘函数工具：
invoke_function: 调用边缘函数- 用户管理工具：
list_users: 列出用户create_user: 创建用户update_user: 更新用户delete_user: 删除用户assign_user_role: 分配用户角色remove_user_role: 移除用户角色
常见问题解答
- 错误处理：服务器提供标准化的错误格式，包含错误代码、消息和详细信息
- 配置问题：确保正确配置环境变量和配置文件
- 权限问题：检查服务角色密钥和访问令牌是否正确
使用教程
使用依赖
- Node.js 16.x 或更高版本
- Supabase 项目，包含：
- 项目 URL
- 服务角色密钥（用于管理员操作）
- 访问令牌（用于管理操作）
- MCP 兼容客户端
安装教程
- 通过 Smithery 安装：
npx -y @smithery/cli install supabase-server --client claude
- 手动安装：
git clone https://github.com/DynamicEndpoints/supabase-mcp.git
cd supabase-mcp
npm install
cp .env.example .env
# 配置环境变量
cp config.json.example config.json
npm run build
调试方式
- 运行测试：
npm test
- 构建项目：
npm run build
- 代码检查：
npm run lint