🚀 Supabase MCP 服务器
Supabase MCP 服务器是一个模型上下文协议 (MCP) 服务器，它能让 AI 助手借助标准化工具与 Supabase 数据库进行交互，有效提升数据交互的效率与规范性。
🚀 快速开始
运行 MCP 服务器，你可以按照以下步骤操作：
python -m supabase_mcp.server
✨ 主要特性
- 可从表格中读取带有过滤和列选择的行，精准获取所需数据。
- 支持创建单条或多条记录，满足不同的数据插入需求。
- 能使用灵活的过滤条件更新记录，方便数据的动态修改。
- 可安全删除符合特定条件的记录，保障数据的清理与管理。
- 环境基于配置，便于根据不同场景进行定制。
- 提供标准化 I/O 运输支持，增强数据传输的规范性。
📦 安装指南
- 克隆仓库:
git clone
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
💻 使用示例
基础用法
本部分介绍了 Supabase MCP 服务器提供的几个主要工具的使用示例。
read_rows
从 Supabase 表中读取数据，带有可选的过滤和列选择。
{
"table": "users",
"columns": ["id", "name", "email"], # 可选
"filters": {"is_active": true}, # 可选
"limit": 10 # 可选
}
create_records
向表中插入一条或多条记录。
{
"table": "users",
"records": {
"name": "John Doe",
"email": "john@example.com"
}
# 或多条记录:
# "records": [
# {"name": "John", "email": "john@example.com"},
# {"name": "Jane", "email": "jane@example.com"}
# ]
}
update_records
更新符合特定过滤条件的记录。
{
"table": "users",
"filters": {"id": 123},
"data": {"status": "active"}
}
delete_records
删除符合特定过滤条件的记录。
{
"table": "users",
# 此处原文档未完整，推测后续应有过滤条件
}