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

💻 使用示例

基础用法

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",
    "filters": {"id": 123}
}