
Supabase MCP Server

2025.04.06
0
Python数据库管理AI助手工具数据库
Supabase MCP Server 是一个模型上下文协议(MCP)服务器,为AI助手提供了通过标准化工具与Supabase数据库交互的能力。它支持读取、创建、更新和删除数据库记录,并提供了环境配置和Stdio传输支持。
View on GitHub
Overview
基本能力
产品定位
Supabase MCP Server 是一个用于AI助手与Supabase数据库交互的中间件服务,通过标准化工具简化数据库操作。
核心功能
- 从表中读取行数据,支持过滤和列选择
- 创建单条或多条记录
- 更新记录,支持灵活的过滤条件
- 安全删除记录,支持过滤条件
- 基于环境的配置
- Stdio传输支持
适用场景
- AI助手需要与Supabase数据库交互的场景
- 需要标准化数据库操作的自动化流程
- 开发环境中的数据库管理工具
工具列表
- read_rows: 从Supabase表中读取数据,支持过滤和列选择。
- create_records: 向表中插入一条或多条记录。
- update_records: 更新表中匹配特定过滤条件的记录。
- delete_records: 删除表中匹配特定过滤条件的记录。
常见问题解答
- 安全性: 使用服务角色密钥进行数据库操作,所有输入通过Pydantic模型验证。
- 环境配置: 需要在项目根目录创建
.env
文件,配置SUPABASE_URL
和SUPABASE_SERVICE_KEY
。
使用教程
使用依赖
- 克隆仓库:
git clone <repository-url>
cd mcp
- 创建虚拟环境并安装依赖:
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
- 设置环境变量:
在项目根目录创建
.env
文件,内容如下:
SUPABASE_URL=your_project_url
SUPABASE_SERVICE_KEY=your_service_role_key
安装教程
- 完成上述依赖安装后,运行MCP服务器:
python -m supabase_mcp.server
调试方式
- 确保虚拟环境已激活。
- 确保
.env
文件配置正确。 - 运行服务器后,可以通过工具列表中的命令进行调试。