Supabase MCP Bridge

Supabase MCP桥

一个轻量级的无服务器API桥，使Claude（通过MCP）能够查询、修改和设置Subabase数据库。部署在Vercel上。

特性

• CRUD操作：通过REST API查询、插入和更新Subase表
• 模式管理：动态创建表和架构
• 无服务器：与Vercel无服务器功能完全兼容

项目结构

supabase-mcp-bridge/
 ├── api/
 │    ├── index.js      ← CRUD endpoint
 │    └── schema.js     ← Schema creation endpoint
 ├── package.json
 ├── .gitignore
 └── README.md

设置

1.安装依赖项

npm install

2.环境变量

在Vercel项目设置中添加以下环境变量→ 环境变量：

SUPABASE_URL = https://your-project-id.supabase.co
SUPABASE_SERVICE_ROLE_KEY = your_service_role_key_here

重要：使用服务角色键（不是anon键）进行完全数据库访问。

3.部署到Vercel

vercel

或者将您的GitHub存储库连接到Vercel进行自动部署。

API终点

CRUD端点： /api

获取请求

返回健康检查状态：

curl https://supabase-mcp-bridge.vercel.app/api

答复：

{ "status": "Supabase MCP Bridge Active ✅" }

POST 请求

执行CRUD操作：

curl -X POST https://supabase-mcp-bridge.vercel.app/api \
  -H "Content-Type: application/json" \
  -d '{
    "action": "select|insert|update",
    "table": "",
    "data": {},
    "query": "*"
  }'

参数：

• action：其中之一 select, insert，或 update
• table：Supabase表的名称
• data：包含插入/更新操作数据的对象
• query：选择操作的列选择（默认值： "*")

示例：

选择所有记录：

{
  "action": "select",
  "table": "bots",
  "query": "*"
}

插入记录：

{
  "action": "insert",
  "table": "bots",
  "data": {
    "name": "My Bot",
    "type": "chatbot",
    "model_choice": "gpt-4"
  }
}

更新记录：

{
  "action": "update",
  "table": "bots",
  "data": {
    "id": "uuid-here",
    "name": "Updated Bot Name"
  }
}

架构终结点： /api/schema

根据请求的实体动态创建表：

curl -X POST https://supabase-mcp-bridge.vercel.app/api/schema \
  -H "Content-Type: application/json" \
  -d '{"entities":["organizations","members","bots","channels","leads"]}'

可用实体：

• organizations：组织表（id、名称、created_at）
• members：成员表（id、org_id、电子邮件、角色、created_at）
• bots：机器人表（id、org_id、名称、类型、model_choice、设置、created_at）
• channels：通道表（id、bot_id、类型、external_id、状态）
• leads：Leads表（id、bot_id、姓名、电话、电子邮件、zip、意图、信心、created_at）

测试

测试CRUD端点

curl -X POST https://supabase-mcp-bridge.vercel.app/api \
  -H "Content-Type: application/json" \
  -d '{"action":"select","table":"bots","query":"*"}'

测试架构终结点

curl -X POST https://supabase-mcp-bridge.vercel.app/api/schema \
  -H "Content-Type: application/json" \
  -d '{"entities":["bots","leads"]}'

MCP集成

将网桥URL添加到Claude Desktop：

1. 打开克劳德桌面→ 设置
2. 转到连接器→ 添加自定义连接器
3. 将远程MCP服务器URL设置为： https://supabase-mcp-bridge.vercel.app/api

许可证

麻省理工学院