Сервер Model Context Protocol (MCP), предоставляющий инструменты для взаимодействия с базой данных Supabase. Этот сервер позволяет ассистентам ИИ выполнять операции с базой данных через стандартизированный интерфейс.

ПРИМЕЧАНИЕ: Этот сервер Supabase MCP был создан как демонстрация моего рабочего процесса по программированию AI IDE. Это всё ещё работа над работой, о которой я расскажу в будущих видео на своём канале.

Особенности

• Чтение строк таблицы: запрос данных из таблиц Supabase с опциональной фильтрацией, пагинацией и выбором столбцов
• Создать записи таблицы: Вставить новые записи в таблицы Supabase
• Обновить записи таблицы: Изменять существующие записи в таблицах Supabase на основе фильтров
• Удалить записи таблицы: Удалить записи из таблиц Supabase на основе фильтров

Предварительные требования

• Docker или Docker Desktop
• Аккаунт и проект Supabase

Установка

1. Клонировать репозиторий:

Настройка Docker

1. Создайте имидж Docker:

Использование

Запуск как MCP-сервер с Docker

Сервер Supabase MCP может быть интегрирован с AI-ассистентами с помощью протокола Model Context Protocol.

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]