Servidor MCP Do Supabase

🚀 Supabase 服务器 MCP

这是一个提供 RESTful API 的 MCP（模型-控制器-持久层）服务器，用于与 Supabase 进行交互，可实现表数据查询、插入和更新等操作。

🚀 快速开始

本服务器可在本地运行，也可部署到 Smithery 平台。下面为你详细介绍操作步骤。

✨ 主要特性

• 表数据查询
• 特定记录查询
• 数据插入
• 数据更新

📦 安装指南

本地配置

1. 克隆仓库。
2. 安装依赖：

   npm install
   

3. 复制 .env.example 文件并重命名为 .env，然后填写您的 Supabase 凭据：

   cp .env.example .env
   

在 Smithery 上部署

1. 安装 Smithery CLI：

   npm install -g @smithery/cli
   

2. 登录您的 Smithery 账户：

   smithery login
   

3. 在项目目录中初始化部署：

   smithery deploy
   

4. 在 Smithery 控制面板中配置环境变量：
   • SUPABASE_URL：您的 Supabase 项目的 URL
   • SUPABASE_KEY：您的 Supabase 项目的 API 密钥
5. 部署完成后，您的服务器将在 Smithery 提供的域名下可用。

💻 使用示例

基础用法

启动服务器：

npm start

高级用法

接口端点

• GET /api/:table - 列出表中的所有记录

  • 查询参数：
    • select：要返回的字段（可选）

• GET /api/:table/:id - 通过 ID 获取特定记录

• POST /api/:table - 插入新记录

  • 请求体：包含要插入的数据的对象

• PATCH /api/:table/:id - 更新现有记录

  • 请求体：包含要更新的字段的对象

示例请求

列出表中的所有记录

curl http://localhost:3000/api/users

带特定字段的记录列表

curl http://localhost:3000/api/users?select=id,name,email

获取特定记录

curl http://localhost:3000/api/users/123

插入新记录

curl -X POST http://localhost:3000/api/users \
  -H "Content-Type: application/json" \
  -d '{"name": "João", "email": "joao@exemplo.com"}'

更新记录

curl -X PATCH http://localhost:3000/api/users/123 \
  -H "Content-Type: application/json" \
  -d '{"name": "João Silva"}'

📚 详细文档

在 Smithery 上监控

部署完成后，您可以通过 Smithery 控制面板监控您的服务器：

1. 访问 Smithery 控制面板。
2. 浏览到您的项目。
3. 查看：
   • 实时日志
   • 使用指标
   • 服务器状态
   • 环境变量