Supabase MCP Server Kd5

🚀 Supabase MCP 服務器

Supabase MCP 服務器是一個提供與 Supabase 數據庫交互工具的模型上下文協議 (MCP) 服務器。它通過標準化接口，讓 AI 助手能夠輕鬆執行數據庫操作，為開發者提供了便捷的數據庫交互方式。

⚠️ 重要提示

這個 Supabase MCP 服務器是作者在 我的頻道 的視頻中演示其 AI IDE 編碼工作流程的示例。它仍是一個正在進行中的項目，未來會繼續擴展完善。

🚀 快速開始

Supabase MCP 服務器旨在為 AI 助手提供與 Supabase 數據庫交互的能力。下面將為你介紹使用該服務器的基本步驟。

✨ 主要特性

• 讀取錶行：可以帶有可選篩選、分頁和列選擇從 Supabase 表查詢數據。
• 創建表記錄：能夠向 Supabase 表插入新記錄。
• 更新表記錄：可根據篩選條件修改現有記錄。
• 刪除表記錄：能根據篩選條件刪除記錄。

📦 安裝指南

先決條件

• Docker 或 Docker Desktop
• Supabase 賬戶和項目

克隆倉庫

git clone https://github.com/coleam00/supabase-mcp.git
cd supabase-mcp

💻 使用示例

Docker 設置

構建 Docker 鏡像

FROM python:3.8-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
EXPOSE 5000
CMD ["python", "server.py"]

運行 Docker 容器

docker build -t mcp/supabase .
docker run -e SUPABASE_URL=your-supabase-url -e SUPABASE_SERVICE_KEY=your-service-role-key -it mcp/supabase

可用工具

讀取錶行

def read_table_records(table_name: str, 
                      column_names: List[str] = ["*"], 
                      filter_conditions: Optional[List[Tuple[str, str, str]]] = None,
                      page: int = 1,
                      per_page: int = 10) -> Dict:
    """
    從指定表中讀取記錄。
    
    參數:
        table_name (str): 表名
        column_names (List[str]): 要返回的列名稱，默認為 ["*"]，表示所有列
        filter_conditions (Optional[List[Tuple[str, str, str]]]): 篩選條件列表，每個元組包含 (column, operator, value)
        page (int): 當前頁碼，默認為 1
        per_page (int): 每頁顯示的記錄數，默認為 10
    
    返回:
        Dict: 包含查詢結果、總記錄數和分頁信息的字典
    """

創建表記錄

def create_table_record(table_name: str, 
                      record_data: Dict[str, Any]) -> bool:
    """
    向指定表中插入新記錄。
    
    參數:
        table_name (str): 表名
        record_data (Dict[str, Any]): 新記錄的數據字典
        
    返回:
        bool: 操作是否成功
    """

更新表記錄

def update_table_record(table_name: str,
                      filter_conditions: List[Tuple[str, str, str]],
                      update_data: Dict[str, Any]) -> int:
    """
    根據篩選條件更新指定表中的記錄。
    
    參數:
        table_name (str): 表名
        filter_conditions (List[Tuple[str, str, str]]): 篩選條件列表，每個元組包含 (column, operator, value)
        update_data (Dict[str, Any]): 要更新的數據字典
        
    返回:
        int: 更新的記錄數
    """

刪除表記錄

def delete_table_records(table_name: str,
                      filter_conditions: List[Tuple[str, str, str]]) -> int:
    """
    根據篩選條件刪除指定表中的記錄。
    
    參數:
        table_name (str): 表名
        filter_conditions (List[Tuple[str, str, str]]): 篩選條件列表，每個元組包含 (column, operator, value)
        
    返回:
        int: 刪除的記錄數
    """

📚 詳細文檔

開發信息

項目結構

supabase-mcp/
├── server.py              # MCP 服務器入口
├── requirements.txt      # 依賴管理
└── docker/Dockerfile     # Docker 鏡像配置

測試方法

運行測試用例

pytest tests/

覆蓋率報告

coverage run -m pytest tests/ && coverage report

協議整合

工作原理

1. MCP 服務器提供數據庫操作工具 (讀取、創建、更新、刪除)。
2. AI 助手通過 stdio 運輸連接到 MCP 服務器。
3. AI 助手可以調用工具執行數據庫操作。
4. MCP 服務器處理與 Supabase 的通信並返回結果。

配置示例

{
  "mcpServers": {
    "supabase": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "SUPABASE_URL", "-e", "SUPABASE_SERVICE_KEY", "mcp/supabase"],
      "env": {
        "SUPABASE_URL": "YOUR-SUPABASE-URL",
        "SUPABASE_SERVICE_KEY": "YOUR-SERVICE-ROLE-KEY"
      }
    }
  }
}

環境變量

📄 許可證

本項目採用 MIT License。

貢獻者

• [你的名字] - 初始開發