Supabase MCP Server R4b

🚀 Supabase MCP 服務器

Supabase MCP 服務器是一個模型上下文協議（MCP）服務器，它能讓 AI 助手藉助標準化工具與 Supabase 數據庫進行交互，有效提升數據處理的效率和規範性。

🚀 快速開始

運行 MCP 服務器，你可以按照以下步驟操作：

python -m supabase_mcp.server

✨ 主要特性

• 🔍 支持從表格中讀取帶有過濾和列選擇的行。
• ✍️ 可創建單條或多條記錄。
• 🔄 能使用靈活的過濾條件更新記錄。
• 🗑️ 可安全刪除符合特定條件的記錄。
• ⚙️ 環境基於配置，方便靈活調整。
• 📦 提供標準化 I/O 運輸支持。

📦 安裝指南

1. 克隆倉庫：

git clone <repository-url>
cd mcp

2. 創建虛擬環境並安裝依賴項：

python -m venv .venv
source .venv/bin/activate  # Windows 上: .venv\Scripts\activate
pip install -r requirements.txt

3. 設置環境變量： 在項目根目錄中創建一個 .env 文件，內容如下：

SUPABASE_URL=your_project_url
SUPABASE_SERVICE_KEY=your_service_role_key

💻 使用示例

基礎用法

read_rows

從 Supabase 表中讀取數據，帶有可選的過濾和列選擇。

{
    "table": "users",
    "columns": ["id", "name", "email"],  # 可選
    "filters": {"is_active": true},      # 可選
    "limit": 10                          # 可選
}

create_records

向表中插入一條或多條記錄。

{
    "table": "users",
    "records": {
        "name": "John Doe",
        "email": "john@example.com"
    }
    # 或多條記錄:
    # "records": [
    #     {"name": "John", "email": "john@example.com"},
    #     {"name": "Jane", "email": "jane@example.com"}
    # ]
}

update_records

更新符合特定過濾條件的記錄。

{
    "table": "users",
    "filters": {"id": 123},
    "data": {"status": "active"}
}

delete_records

刪除符合特定過濾條件的記錄。

{
    "table": "users",
    "filters": {"id": 123}
}