hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Enables querying Supabase database tables with filtering options and generating TypeScript types from database schemas
Generates TypeScript type definitions from Supabase database schemas for use in development

Supabase MCP 서버

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

특징

쿼리 테이블 : 다음을 지원하여 모든 테이블에 대한 쿼리를 실행합니다.
- 스키마 선택
- 열 필터링
- 여러 연산자가 있는 Where 절
- 쪽수 매기기
- 오류 처리
유형 생성 : 데이터베이스에 대한 TypeScript 유형을 생성합니다.
- 모든 스키마(public, auth, api 등) 지원
- 로컬 및 원격 Supabase 프로젝트 모두에서 작동합니다.
- 콘솔에 직접 출력
- 자동 프로젝트 참조 감지

필수 조건

Node.js(v16 이상)
Supabase 프로젝트(로컬 또는 호스팅)
Supabase CLI(유형 생성용)

설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

npm install

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

# Using npm
npm install -g supabase

# Or using Homebrew on macOS
brew install supabase/tap/supabase

구성

Supabase 자격증을 받으세요:
- 호스팅 프로젝트의 경우:
  1. Supabase 프로젝트 대시보드로 이동하세요
  2. 프로젝트 설정 > API로 이동하세요.
  3. 프로젝트 URL과 service_role 키를 복사하세요(anon 키가 아님)
- 로컬 프로젝트의 경우:
  1. 로컬 Supabase 인스턴스를 시작하세요
  2. 로컬 URL을 사용하세요(일반적으로 http://localhost:54321 )
  3. 로컬 service_role 키를 사용하세요
환경 변수 구성:

# Create a .env file (this will be ignored by git)
echo "SUPABASE_URL=your_project_url
SUPABASE_KEY=your_service_role_key" > .env

서버를 빌드하세요:

npm run build

Claude Desktop과 통합

Claude Desktop 설정 열기:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- 리눅스: ~/.config/Claude/claude_desktop_config.json
서버 구성을 추가합니다.

{
  "mcpServers": {
    "supabase": {
      "command": "node",
      "args": ["/absolute/path/to/supabase-mcp-server/build/index.js"],
      "env": {
        "SUPABASE_URL": "your_project_url",
        "SUPABASE_KEY": "your_service_role_key"
      }
    }
  }
}

VSCode 확장 프로그램과의 통합

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
서버 구성을 추가합니다(Claude Desktop과 동일한 형식).

사용 예

테이블 쿼리

// Query with schema selection and where clause
<use_mcp_tool>
<server_name>supabase</server_name>
<tool_name>query_table</tool_name>
<arguments>
{
  "schema": "public",
  "table": "users",
  "select": "id,name,email",
  "where": [
    {
      "column": "is_active",
      "operator": "eq",
      "value": true
    }
  ]
}
</arguments>
</use_mcp_tool>

유형 생성

// Generate types for public schema
<use_mcp_tool>
<server_name>supabase</server_name>
<tool_name>generate_types</tool_name>
<arguments>
{
  "schema": "public"
}
</arguments>
</use_mcp_tool>

사용 가능한 도구

쿼리_테이블

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

매개변수:

schema (선택 사항): 데이터베이스 스키마(기본값은 public)
table (필수): 쿼리할 테이블의 이름
select (선택 사항): 쉼표로 구분된 열 목록
where (선택 사항): 다음 조건을 포함하는 조건 배열:
- column : 열 이름
- operator : eq, neq, gt, gte, lt, lte, like, ilike, is 중 하나
- value : 비교할 값

생성_유형

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

매개변수:

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

문제 해결

유형 생성 문제

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

supabase --version

로컬 프로젝트의 경우:
- 로컬 Supabase 인스턴스가 실행 중인지 확인하세요.
- service_role 키가 올바른지 확인하세요
호스팅 프로젝트의 경우:
- 프로젝트 참조가 올바른지 확인하세요(URL에서 추출)
- anon 키가 아닌 service_role 키를 사용하고 있는지 확인하세요.

쿼리 문제

스키마와 테이블 이름을 확인하세요
select 및 where 절에서 열 이름 확인
service_role 키에 필요한 권한이 있는지 확인하세요.

기여하다

저장소를 포크하세요
기능 브랜치를 만듭니다: git checkout -b feature/my-feature
변경 사항을 커밋하세요: git commit -am 'Add my feature'
브랜치에 푸시: git push origin feature/my-feature
풀 리퀘스트 제출

특허

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

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Model Context Protocol 인터페이스를 통해 Supabase 데이터베이스를 쿼리하고 TypeScript 유형을 생성할 수 있으며, 스키마 선택, 열 필터링, 페이지 매김과 같은 기능을 지원합니다.

Related Resources

Reddit Discussion about this server

Supabase MCP Server