Servidor MCP Do Supabase

🚀 Supabase 服务器 MCP

这是一个用于与 Supabase 交互的 MCP（模型 - 控制器 - 持久层）服务器，它提供了 RESTful API，能帮助开发者更便捷地操作 Supabase 相关数据。

🚀 快速开始

本服务器可在本地进行配置和使用，也能部署到 Smithery 平台。下面为你详细介绍操作步骤。

✨ 主要特性

• 表数据查询：可对 Supabase 中的表数据进行查询操作。
• 特定记录查询：能根据记录 ID 精准获取特定记录。
• 数据插入：支持向表中插入新的数据记录。
• 数据更新：可对已有的数据记录进行更新。

📦 安装指南

本地配置

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. 查看：
   • 实时日志
   • 使用指标
   • 服务器状态
   • 环境变量