Supabase MCP Server R4b

🚀 Supabase MCP 服务器

Supabase MCP 服务器是一个模型上下文协议 (MCP) 服务器，它能让 AI 助手借助标准化工具与 Supabase 数据库进行交互，有效提升数据交互的效率与规范性。

🚀 快速开始

运行 MCP 服务器，你可以按照以下步骤操作：

python -m supabase_mcp.server

✨ 主要特性

• 可从表格中读取带有过滤和列选择的行，精准获取所需数据。
• 支持创建单条或多条记录，满足不同的数据插入需求。
• 能使用灵活的过滤条件更新记录，方便数据的动态修改。
• 可安全删除符合特定条件的记录，保障数据的清理与管理。
• 环境基于配置，便于根据不同场景进行定制。
• 提供标准化 I/O 运输支持，增强数据传输的规范性。

📦 安装指南

1. 克隆仓库:

git clone <repository-url>
cd mcp

2. 创建虚拟环境并安装依赖项:

python -m venv .venv
source .venv/bin/activate  # Windows 上: .venv\Scripts\activate
pip install -r requirements.txt

3. 设置环境变量: 在项目根目录中创建一个 .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",
    # 此处原文档未完整，推测后续应有过滤条件
}