Supabase 데이터베이스와 상호작용할 수 있는 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 AI 보조자가 표준화된 인터페이스를 통해 데이터베이스 작업을 수행할 수 있도록 합니다.

참고: 이 Supabase MCP 서버는 제 AI IDE 코딩 워크플로우를 시연하기 위해 만들어졌습니다. 아직 진행 중인 작업이며, 앞으로의 제 채널 영상에서 더 자세히 다룰 예정입니다.

특징

• 테이블 행 읽기: 선택적 필터링, 페이지네이션, 열 선택 기능이 있는 Supabase 테이블에서 데이터를 쿼리할 수 있습니다
• 테이블 레코드 생성: Supabase 테이블에 새 레코드를 삽입합니다
• 테이블 레코드 업데이트: 필터를 기반으로 Supabase 테이블의 기존 레코드를 수정합니다
• 테이블 레코드 삭제: 필터를 기반으로 Supabase 테이블에서 레코드를 제거합니다

선수 조건

• 도커 또는 도커 데스크톱
• Supabase 계정 및 프로젝트

설치

1. 저장소 복제:

도커 설정

1. Docker 이미지 빌드:

사용

Docker 사용 MCP 서버로 실행 중

Supabase MCP 서버는 모델 컨텍스트 프로토콜을 사용하여 AI 어시스턴트와 통합할 수 있습니다.

1. 아래 구성을 MCP 설정(Claude Desktop, Windsurf 등)에 포함하세요.

Supabase MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with a Supabase database. This server enables AI assistants to perform database operations through a standardized interface.

NOTE: This Supabase MCP server was created as a demonstration of my AI IDE coding workflow. It is still a work in progress which I will expand on in future videos on my channel.

Features

• Read Table Rows: Query data from Supabase tables with optional filtering, pagination, and column selection
• Create Table Records: Insert new records into Supabase tables
• Update Table Records: Modify existing records in Supabase tables based on filters
• Delete Table Records: Remove records from Supabase tables based on filters

Prerequisites

• Docker or Docker Desktop
• Supabase account and project

Installation

1. Clone the repository:

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

Docker Setup

1. Build the Docker image:

   docker build -t mcp/supabase .
   

Usage

Running as an MCP Server with Docker

The Supabase MCP server can be integrated with AI assistants using the Model Context Protocol.

1. Include the below configuration in your MCP config (in Claude Desktop, Windsurf, etc.)

Be sure to build the container with the installation steps first!

{
  "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-SUPABASE-SERVICE-ROLE-KEY"
      }
    }
  }
}

2. Replace YOUR-SUPABASE-URL and YOUR-SUPABASE-SERVICE-ROLE-KEY with your actual Supabase credentials.

3. The AI assistant can now access the Supabase database through the MCP server using the provided tools.

For more information on the Model Context Protocol, visit modelcontextprotocol.io.

Available Tools

Read Table Rows

read_table_rows(
    table_name: str,
    columns: Optional[List[str]] = None,
    filters: Optional[Dict[str, Any]] = None,
    limit: Optional[int] = None,
    offset: Optional[int] = None
)

Example:

# Read active users
read_table_rows(
    table_name="users",
    columns=["id", "name", "email"],
    filters={"is_active": True},
    limit=10,
    offset=0
)

Create Table Records

create_table_records(
    table_name: str,
    records: Union[Dict[str, Any], List[Dict[str, Any]]]
)

Example:

# Create a new user
create_table_records(
    table_name="users",
    records={
        "name": "John Doe",
        "email": "[email protected]",
        "is_active": True
    }
)

Update Table Records

update_table_records(
    table_name: str,
    updates: Dict[str, Any],
    filters: Dict[str, Any]