SB MCP

🚀 Supabase MCP 服務器

Supabase MCP 服務器是一個模型上下文協議（MCP）服務器，它能讓 Claude 和其他大型語言模型與 Supabase 進行交互，實現對 Postgres 表的 CRUD 操作，為數據處理提供便利。

🚀 快速開始

在使用 Supabase MCP 服務器之前，你需要完成安裝和配置工作，然後就可以啟動服務器並進行數據庫操作啦。

✨ 主要特性

• 數據庫操作：
  • 數據查詢：可使用過濾器精準查詢數據。
  • 數據插入：能方便地向數據庫插入新數據。
  • 數據更新：對已有數據進行修改更新。
  • 數據刪除：刪除不需要的數據。
  • 表格列出：查看數據庫中的表格。

📦 安裝指南

選項 1：通過 npm 安裝（推薦）

該包已發佈到 npm，你可以選擇全局安裝或在項目中本地安裝。

• 全局安裝：

npm install -g supabase-mcp

• 本地安裝：

npm install supabase-mcp

選項 2：克隆倉庫

git clone https://github.com/Cappahccino/SB-MCP.git
cd SB-MCP
npm install
npm run build

📚 詳細文檔

配置

在項目根目錄創建一個名為 mcp.json 的文件，並添加以下內容：

{
  "supabase": {
    "url": "YOUR_SUPABASE_URL",
    "anonKey": "YOUR_SUPABASE_ANON_KEY"
  }
}

請將 YOUR_SUPABASE_URL 和 YOUR_SUPABASE_ANON_KEY 替換為你實際的 Supabase 項目 URL 和匿名密鑰。

使用

作為獨立服務器

運行以下命令啟動 MCP 服務器：

node index.js

集成到其他項目中

在項目中引入並使用：

const { MCP } = require('supabase-mcp');
const mcp = new MCP();

// 查詢數據
mcp.query('your-supabase-project-id', {
  query: {
    table: 'users',
    where: {
      id: 1
    }
  },
  response: {
    format: 'json'
  }
}).then(console.log);

// 插入數據
mcp.execute('your-supabase-project-id', {
  command: 'insert',
  data: { name: 'Alice' },
  query: {
    table: 'users'
  }
});

故障排除

常見問題及解決方案

• 問題：無法連接到 Supabase

  • 確保你已經在 mcp.json 中正確配置了你的項目 URL 和密鑰。

• 問題：查詢返回空結果

  • 檢查過濾器是否正確，並確保表名存在。

工具參考

數據庫操作命令

查詢數據

{
  "command": "query",
  "project_id": "your-supabase-project-id",
  "data": {
    "table": "users",
    "where": { "id": 1 }
  },
  "response": { "format": "json" }
}

插入數據

{
  "command": "insert",
  "project_id": "your-supabase-project-id", 
  "data": {
    "table": "users",
    "values": { name: 'Alice' }
  }
}

🔧 技術細節

版本歷史

• 1.0.0：初始發佈
• 1.0.1：添加了自動端口選擇
• 1.0.2：修復了協議兼容性問題
• 1.0.3：添加了 JSON-RPC 支持
• 1.1.0：完全重寫為官方 MCP SDK
• 1.2.0：新增獨立的 Claude 傳輸並修復端口衝突問題
• 1.3.0：更新以提高與 TypeScript 項目的兼容性
• 1.4.0：根據 Supabase 社區最佳實踐修復了 Claude 標準輸入輸出集成
• 1.5.0：移除 Edge Function 支持，專注於數據庫操作穩定性

📄 許可證

本項目採用 MIT 許可證。