alexander-zuev/supabase-mcp-server

해결하는 문제

이 프로젝트는 AI 기반 IDE(예: Cursor, Windsurf, Cline 등)가 Supabase 프로젝트와 안전하게 상호작용할 수 있도록 해주는 Model Context Protocol (MCP) 서버를 제공합니다. 개발자가 IDE와 Supabase 대시보드 사이를 수동으로 전환할 필요 없이 SQL 쿼리 실행, 데이터베이스 스키마 관리, 사용자 인증 처리를 모두 가능하게 합니다.

작동 방식

서버는 MCP 호환 클라이언트와 Supabase 인스턴스 사이의 다리 역할을 합니다. IDE와는 stdio 프로토콜을 사용해 통신하며, 데이터베이스 작업은 트랜잭션 풀링을 통해, 프로젝트 관리는 Supabase Management API를 통해, 사용자 관리는 Auth Admin SDK를 통해 연결합니다. SQL 쿼리를 세 가지 위험 수준(안전, 쓰기, 파괴적)으로 분류하는 내장된 안전 시스템을 통해 실수로 데이터 손실이 발생하는 것을 방지합니다.

대상 사용자

Supabase를 백엔드로 사용하고 AI 기반 IDE를 활용하여 데이터베이스와 사용자를 직접 AI 에이전트를 통해 관리하고자 하는 개발자들입니다.

주요 특징

• 3단계 안전 시스템: SQL 작업을 안전(읽기 전용), 쓰기(데이터 수정), 파괴적(스키마 변경)으로 분류하여 사고를 방지합니다.
• IDE 통합: Cursor, Windsurf, Cline, Claude Desktop과 네이티브 호환입니다.
• 포괄적인 관리: SQL 실행, 스키마 버전 관리, Supabase Management API 호출, Auth Admin SDK 메서드를 모두 지원합니다.
• 위험 평가: PostgreSQL 파서를 사용해 런타임 SQL 쿼리 검증 및 위험 수준 평가를 수행합니다.