Supabase MCP Server

Supabase MCP Server

site icon
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数据库交互的场景
  • 需要标准化数据库操作的自动化流程
  • 开发环境中的数据库管理工具

工具列表

  1. read_rows: 从Supabase表中读取数据,支持过滤和列选择。
  2. create_records: 向表中插入一条或多条记录。
  3. update_records: 更新表中匹配特定过滤条件的记录。
  4. delete_records: 删除表中匹配特定过滤条件的记录。

常见问题解答

  • 安全性: 使用服务角色密钥进行数据库操作,所有输入通过Pydantic模型验证。
  • 环境配置: 需要在项目根目录创建.env文件,配置SUPABASE_URLSUPABASE_SERVICE_KEY

使用教程

使用依赖

  1. 克隆仓库:
git clone <repository-url>
cd mcp
  1. 创建虚拟环境并安装依赖:
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt
  1. 设置环境变量: 在项目根目录创建.env文件,内容如下:
SUPABASE_URL=your_project_url
SUPABASE_SERVICE_KEY=your_service_role_key

安装教程

  1. 完成上述依赖安装后,运行MCP服务器:
python -m supabase_mcp.server

调试方式

  1. 确保虚拟环境已激活。
  2. 确保.env文件配置正确。
  3. 运行服务器后,可以通过工具列表中的命令进行调试。

许可证

该项目遵循 MIT 开源许可条款。