Supabase MCP 서버
AI 도구가 Supabase 데이터베이스와 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 Supabase 테이블의 레코드를 읽고, 생성하고, 업데이트하고, 삭제하는 도구를 제공합니다.
특징
- 필터링 및 열 선택을 통해 모든 Supabase 테이블에서 행을 읽습니다.
- 테이블에 단일 또는 여러 레코드 생성
- 필터 조건에 따라 레코드 업데이트
- 필터 조건에 따라 레코드 삭제
- AI 모델 이해를 위한 포괄적인 도구 설명
- Pydantic을 사용한 유형 안전 요청/응답 처리
- 간편한 배포를 위한 Docker 지원
필수 조건
- 파이썬 3.9 이상
- Docker와 Docker Compose
- 서비스 역할 키가 있는 Supabase 프로젝트
- FastMCP 호환 AI IDE
설치
- 저장소를 복제합니다.
지엑스피1
- Supabase 자격 증명으로
.env 파일을 만듭니다.
cp .env.example .env
# Edit .env with your Supabase credentials:
# SUPABASE_URL=your-project-url
# SUPABASE_KEY=your-service-role-key
- 컨테이너를 빌드하고 시작합니다.
# Build and start in detached mode
docker-compose up --build -d
# To view logs
docker-compose logs -f
# To stop the container
docker-compose down
서버는 http://localhost:8000 에서 사용할 수 있습니다.
Docker 관리 명령
# Start the container
docker-compose up
# Start in detached mode (background)
docker-compose up -d
# Stop the container
docker-compose down
# View logs
docker-compose logs -f
# Rebuild the container
docker-compose up --build
# Check container status
docker-compose ps
# Restart the container
docker-compose restart
Docker 문제 해결
- 컨테이너가 시작되지 않는 경우:
# Check logs
docker-compose logs -f
# Check container status
docker-compose ps
# Remove and rebuild
docker-compose down
docker-compose up --build
- 포트 충돌이 발생하는 경우:
# Stop any existing containers using port 8000
docker-compose down
# Or modify the port in docker-compose.yml
# ports:
# - "8000:8000" # Change the first number to an available port
- 환경 변수가 로드되지 않는 경우:
# Verify .env file exists and has correct values
cat .env
# Check environment variables in container
docker-compose exec mcp-server env
AI IDE에서 MCP 구성
일반 구성 단계
- AI IDE의 설정/환경 설정을 엽니다.
- MCP 또는 AI 설정 섹션으로 이동합니다.
- 다음 구성으로 새로운 MCP 서버를 추가합니다.
{
"name": "Supabase MCP",
"command": "docker-compose",
"args": ["up"],
"cwd": "/path/to/supabase-mcp"
}
IDE별 지침
커서
- 설정 열기(⌘ 또는 Ctrl+,)
- "AI" 섹션으로 이동
- "MCP 서버"에서 "서버 추가"를 클릭하세요.
- 위의 구성을 사용하세요
- 변경 사항을 적용하려면 커서를 다시 시작하세요.
AI 확장 기능을 갖춘 VS 코드
- 명령 팔레트 열기(⌘⇧P 또는 Ctrl+Shift+P)
- "MCP" 또는 "AI 설정"을 검색하세요.
- 새로운 MCP 서버 구성 추가
- 위의 구성을 사용하세요
- VS 코드 창 다시 로드
AI 플러그인이 포함된 JetBrains IDE
- 설정 열기(⌘ 또는 Ctrl+Alt+S)
- "도구" → "AI" → "MCP 서버"로 이동합니다.
- 새로운 서버를 추가하려면 "+"를 클릭하세요
- 위의 구성을 사용하세요
- 변경 사항을 적용하려면 IDE를 다시 시작하세요.
MCP 연결 확인
- MCP 서버 상태를 확인하려면 IDE 상태 표시줄을 확인하세요.
- 녹색 표시기 또는 "MCP 연결됨" 메시지를 찾으세요.
- 데이터베이스 접근이 필요한 AI 기능을 사용해 보세요
- 연결 문제가 있는지 Docker 로그를 확인하세요.
용법
- MCP 서버를 시작합니다.
- MCP 서버를 사용하도록 AI 도구를 구성하세요.
{
"mcpServers": {
"supabase": {
"command": "docker-compose",
"args": ["up"]
}
}
}
사용 가능한 도구
읽기_행
선택적 필터링 및 열 선택을 사용하여 Supabase 테이블에서 행을 읽습니다.
사용 예:
{
"table_name": "users",
"columns": ["id", "name"],
"filters": { "age": { "gt": 18 } },
"limit": 10
}
레코드 생성
Supabase 테이블에 하나 이상의 레코드를 만듭니다.
사용 예:
{
"table_name": "users",
"records": [
{ "name": "John", "age": 30 },
{ "name": "Jane", "age": 25 }
]
}
업데이트_레코드
필터 조건에 따라 Supabase 테이블의 레코드를 업데이트합니다.
사용 예:
{
"table_name": "users",
"filters": { "status": "inactive" },
"updates": { "status": "active" }
}
레코드 삭제
필터 조건에 따라 Supabase 테이블에서 레코드를 삭제합니다.
사용 예:
{
"table_name": "users",
"filters": { "id": 1 }
}
보안 고려 사항
- 항상 보안 환경에서 서비스 역할 키를 사용하세요.
- 클라이언트 측 코드에서 서비스 역할 키를 노출하지 마십시오.
- Supabase에서 적절한 행 수준 보안 정책을 사용하세요
- 프로덕션 사용을 위해 속도 제한 구현을 고려하세요
기여하다
- 저장소를 포크하세요
- 기능 브랜치 생성
- 변경 사항을 커밋하세요
- 지점으로 밀어 넣기
- 풀 리퀘스트 만들기
특허
MIT