Supabase MCP 서버

Supabase 데이터베이스와 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 MCP 인터페이스를 통해 테이블 쿼리 및 TypeScript 유형 생성 도구를 제공합니다.

특징

• 쿼리 테이블 : 다음을 지원하여 모든 테이블에 대한 쿼리를 실행합니다.

  • 스키마 선택

  • 열 필터링

  • 여러 연산자가 있는 Where 절

  • 쪽수 매기기

  • 오류 처리

• 유형 생성 : 데이터베이스에 대한 TypeScript 유형을 생성합니다.

  • 모든 스키마(public, auth, api 등) 지원

  • 로컬 및 원격 Supabase 프로젝트 모두에서 작동합니다.

  • 콘솔에 직접 출력

  • 자동 프로젝트 참조 감지

Related MCP server: Supabase MCP Server

필수 조건

1. Node.js(v16 이상)

2. Supabase 프로젝트(로컬 또는 호스팅)

3. Supabase CLI(유형 생성용)

설치

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

3. Supabase CLI를 설치합니다(유형 생성에 필요):

구성

1. Supabase 자격증을 받으세요:

   • 호스팅 프로젝트의 경우:

     1. Supabase 프로젝트 대시보드로 이동하세요

     2. 프로젝트 설정 > API로 이동하세요.

     3. 프로젝트 URL과 service_role 키를 복사하세요(anon 키가 아님)

   • 로컬 프로젝트의 경우:

     1. 로컬 Supabase 인스턴스를 시작하세요

     2. 로컬 URL을 사용하세요(일반적으로 http://localhost:54321 )

     3. 로컬 service_role 키를 사용하세요

2. 환경 변수 구성:

3. 서버를 빌드하세요:

Claude Desktop과 통합

1. Claude Desktop 설정 열기:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • 리눅스: ~/.config/Claude/claude_desktop_config.json

2. 서버 구성을 추가합니다.

VSCode 확장 프로그램과의 통합

1. VSCode 설정 열기:

   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

   • 리눅스: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. 서버 구성을 추가합니다(Claude Desktop과 동일한 형식).

사용 예

테이블 쿼리

유형 생성

사용 가능한 도구

쿼리_테이블

스키마 선택과 WHERE 절 지원을 사용하여 특정 테이블을 쿼리합니다.

매개변수:

• schema (선택 사항): 데이터베이스 스키마(기본값은 public)

• table (필수): 쿼리할 테이블의 이름

• select (선택 사항): 쉼표로 구분된 열 목록

• where (선택 사항): 다음 조건을 포함하는 조건 배열:

  • column : 열 이름

  • operator : eq, neq, gt, gte, lt, lte, like, ilike, is 중 하나

  • value : 비교할 값

생성_유형

Supabase 데이터베이스 스키마에 대한 TypeScript 유형을 생성합니다.

매개변수:

• schema (선택 사항): 데이터베이스 스키마(기본값은 public)

문제 해결

유형 생성 문제

1. Supabase CLI가 설치되어 있는지 확인하세요.

2. 로컬 프로젝트의 경우:

   • 로컬 Supabase 인스턴스가 실행 중인지 확인하세요.

   • service_role 키가 올바른지 확인하세요

3. 호스팅 프로젝트의 경우:

   • 프로젝트 참조가 올바른지 확인하세요(URL에서 추출)

   • anon 키가 아닌 service_role 키를 사용하고 있는지 확인하세요.

쿼리 문제

1. 스키마와 테이블 이름을 확인하세요

2. select 및 where 절에서 열 이름 확인

3. service_role 키에 필요한 권한이 있는지 확인하세요.

기여하다

1. 저장소를 포크하세요

2. 기능 브랜치를 만듭니다: git checkout -b feature/my-feature

3. 변경 사항을 커밋하세요: git commit -am 'Add my feature'

4. 브랜치에 푸시: git push origin feature/my-feature

5. 풀 리퀘스트 제출

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.