mcp-supabase

Supabase MCP 서버 — Postgres 직접 연결 + Storage REST + Auth + Edge Functions + Management API.

기능

• 24개 도구 — Database, Storage, Auth, Edge Functions, 프로젝트 관리 지원

• Postgres 직접 연결 — pg 풀 사용 (Supabase JS 클라이언트 불필요)

• SSL 지원 — Supabase 풀러용

• 서비스 역할 키 — 관리 작업용

• 액세스 토큰 — Management API용

Related MCP server: Supabase MCP Server - Self-Hosted Edition

설정

cd mcp-supabase
npm install
cp .env.example .env  # Edit with your credentials
node server.cjs

환경 변수

도구

Database

• execute_sql — 임의 SQL 실행

• list_schemas — 데이터베이스 스키마 나열

• list_tables — 스키마의 테이블 나열

• get_schema — 테이블 스키마 세부 정보 가져오기

• get_table_row_counts — 모든 테이블의 행 수 가져오기

• run_rpc — PostgreSQL 함수 호출

Storage

• list_buckets — 스토리지 버킷 나열

• create_bucket — 스토리지 버킷 생성

• delete_bucket — 스토리지 버킷 삭제

• list_files — 버킷의 파일 나열

• upload_file — 파일 업로드

• download_file — 파일 다운로드 (base64)

• delete_file — 파일 삭제

Auth

• list_auth_users — 사용자 나열

• create_auth_user — 사용자 생성

• update_auth_user — 사용자 업데이트

• delete_auth_user — 사용자 삭제

Edge Functions

• list_edge_functions — 배포된 함수 나열

• invoke_edge_function — 함수 호출

Management

• list_projects — 모든 프로젝트 나열

• get_project — 프로젝트 세부 정보 가져오기

MCP 구성

{
  "mcpServers": {
    "supabase": {
      "command": "node",
      "args": ["path/to/server.cjs"]
    }
  }
}

보안 참고 사항

• 서비스 역할 키는 관리자 액세스 권한이 있음 — 주의해서 사용

• .env 또는 config.json을 커밋하지 마세요

• 프로덕션에서는 환경 변수를 사용하세요