MCP 服务器

Supabase MCP Server

用 Python 创建的 Supabase MCP 服务器。

coleam00

开发者工具

访问服务器

README

Supabase MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供与 Supabase 数据库交互的工具。该服务器使 AI 助手能够通过标准化接口执行数据库操作。

注意：此 Supabase MCP 服务器是作为我的 AI IDE 编码工作流程的演示而创建的。它仍然是一个正在进行中的工作，我将在我的频道的未来视频中对其进行扩展。

功能

读取表行: 查询 Supabase 表中的数据，可选择过滤、分页和列选择
创建表记录: 将新记录插入 Supabase 表
更新表记录: 根据过滤器修改 Supabase 表中的现有记录
删除表记录: 根据过滤器从 Supabase 表中删除记录

前提条件

Docker 或 Docker Desktop
Supabase 帐户和项目

安装

克隆存储库：

git clone https://github.com/coleam00/supabase-mcp.git
cd supabase-mcp

Docker 设置

构建 Docker 镜像：
```
docker build -t mcp/supabase .
```

用法

使用 Docker 作为 MCP 服务器运行

Supabase MCP 服务器可以使用模型上下文协议与 AI 助手集成。

在您的 MCP 配置中包含以下配置（在 Claude Desktop、Windsurf 等中）

请务必先使用安装步骤构建容器！

{
  "mcpServers": {
    "supabase": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "SUPABASE_URL", "-e", "SUPABASE_SERVICE_KEY", "mcp/supabase"],
      "env": {
        "SUPABASE_URL": "YOUR-SUPABASE-URL",
        "SUPABASE_SERVICE_KEY": "YOUR-SUPABASE-SERVICE-ROLE-KEY"
      }
    }
  }
}

将 YOUR-SUPABASE-URL 和 YOUR-SUPABASE-SERVICE-ROLE-KEY 替换为您的实际 Supabase 凭据。
现在，AI 助手可以通过 MCP 服务器使用提供的工具访问 Supabase 数据库。

有关模型上下文协议的更多信息，请访问 modelcontextprotocol.io。

可用工具

读取表行

read_table_rows(
    table_name: str,
    columns: Optional[List[str]] = None,
    filters: Optional[Dict[str, Any]] = None,
    limit: Optional[int] = None,
    offset: Optional[int] = None
)

例子:

# 读取活跃用户
read_table_rows(
    table_name="users",
    columns=["id", "name", "email"],
    filters={"is_active": True},
    limit=10,
    offset=0
)

创建表记录

create_table_records(
    table_name: str,
    records: Union[Dict[str, Any], List[Dict[str, Any]]]
)

例子:

# 创建一个新用户
create_table_records(
    table_name="users",
    records={
        "name": "John Doe",
        "email": "john@example.com",
        "is_active": True
    }
)

更新表记录

update_table_records(
    table_name: str,
    updates: Dict[str, Any],
    filters: Dict[str, Any]
)

例子:

# 更新用户状态
update_table_records(
    table_name="users",
    updates={"status": "premium"},
    filters={"is_active": True}
)

删除表记录

delete_table_records(
    table_name: str,
    filters: Dict[str, Any]
)

例子:

# 删除非活跃用户
delete_table_records(
    table_name="users",
    filters={"is_active": False}
)

开发

项目结构

supabase-mcp/
├── supabase_mcp/
│   ├── __init__.py
│   ├── server.py              # 主要 MCP 服务器实现
│   └── tests/                 # 单元测试
├── Dockerfile                 # MCP 服务器的 Docker 配置
├── example_mcp_config.json    # 示例 MCP 配置
├── requirements.txt           # Python 依赖项
├── .env.example               # 示例环境变量
├── README.md                  # 项目文档
├── PLANNING.md                # 项目计划
└── TASKS.md                   # 任务跟踪

运行测试

pytest supabase_mcp/tests/

模型上下文协议集成

Supabase MCP 服务器实现了模型上下文协议，该协议允许 AI 助手以标准化方式与 Supabase 数据库交互。

工作原理

MCP 服务器公开用于数据库操作的工具（读取、创建、更新、删除）
AI 助手使用 stdio 传输连接到 MCP 服务器
AI 助手可以调用这些工具来执行数据库操作
MCP 服务器处理与 Supabase 的通信并返回结果

MCP 配置

example_mcp_config.json 文件显示了如何配置 AI 助手以使用 Supabase MCP 服务器：

{
  "mcpServers": {
    "supabase": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "SUPABASE_URL", "-e", "SUPABASE_SERVICE_KEY", "mcp/supabase"],
      "env": {
        "SUPABASE_URL": "YOUR-SUPABASE-URL",
        "SUPABASE_SERVICE_KEY": "YOUR-SUPABASE-SERVICE-ROLE-KEY"
      }
    }
  }
}