본문 바로가기
M MCP모아

개발 · Google 공식

MCP Toolbox for Databases

구글(googleapis) 조직이 오픈소스로 공개한 데이터베이스용 MCP 서버입니다. prebuilt 옵션으로 Postgres 등 데이터베이스에 바로 연결해 스키마 탐색과 쿼리를 할 수 있고, tools.yaml로 자체 도구를 정의하는 프레임워크로도 쓸 수 있습니다. 저장소가 genai-toolbox에서 mcp-toolbox로 이름이 바뀌어 레지스트리에 두 항목이 있습니다.

연결 방법

Claude Code

claude mcp add toolbox -- npx -y @toolbox-sdk/server --prebuilt=postgres

로컬 실행 명령

npx -y @toolbox-sdk/server --prebuilt=postgres

Claude Desktop — Claude Desktop의 claude_desktop_config.json에 npx 명령과 데이터베이스 접속 환경 변수를 넣어 로컬 서버로 등록합니다.

할 수 있는 일

  • 데이터베이스 스키마 탐색
  • SQL 쿼리 실행
  • prebuilt 도구 세트 사용
  • tools.yaml 기반 맞춤 도구 정의
  • 여러 데이터베이스 지원

이렇게 물어보세요

스키마 파악

“연결된 Postgres 데이터베이스의 테이블 구조를 설명해 줘”

쿼리 작성

“지난달 주문 건수를 일자별로 집계하는 쿼리를 만들어 실행해 줘”

코드 생성

“이 테이블에 맞는 데이터 접근 코드를 작성해 줘”

데이터 흐름과 주의할 점

로컬에서 실행되며 사용자가 지정한 데이터베이스로 직접 접속합니다. 쿼리 결과는 AI 클라이언트로 전달되므로 민감 데이터 노출 범위를 정해야 합니다.

  • 데이터베이스 접속 정보를 로컬 환경 변수로 설정해야 하며 읽기 전용 계정 사용을 권합니다.
  • prebuilt 이름은 지원 데이터베이스마다 다르므로 공식 문서에서 사용할 값을 확인하세요.
  • 이전 이름 genai-toolbox 항목(io.github.googleapis/genai-toolbox)과 새 이름 mcp-toolbox 항목이 레지스트리에 함께 있습니다.