Supabase MCP 服务器

一个模型上下文协议 (MCP) 服务器，使 AI 助手能够通过标准化工具与 Supabase 数据库交互。

特性

• 从表格中读取带有过滤和列选择的行
• 创建单条或多条记录
• 使用灵活的过滤条件更新记录
• 安全删除符合特定条件的记录
• 环境基于配置
• 标准化 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

使用

运行 MCP 服务器:

python -m supabase_mcp.server

可用工具

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",