Supabase MCP 服务器

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

功能特性

• 从表中读取行，支持过滤和列选择
• 创建单个或多个记录
• 更新记录，支持灵活的过滤
• 安全地删除记录，支持过滤条件
• 基于环境变量的配置
• 支持 Stdio 传输

安装

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",
    "filters": {"status": "inactive"}
}

安全性

• 使用服务角色密钥进行数据库操作
• 需要正确的环境配置
• 使用 Pydantic 模型验证所有输入

许可证

MIT 许可证