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. 查看：
   • 即時日誌
   • 使用指標
   • 服務器狀態
   • 環境變量