MCP Toolbox for Databases
DB 연결을 대신 처리하는 구글의 MCP 서버
brew install mcp-toolbox에이전트와 데이터베이스 사이에 서서 연결·인증·커넥션 풀을 대신 맡는 구글 오픈소스 MCP 서버입니다. 미리 만들어진 범용 도구로 바로 붙는 방식과, 쿼리를 직접 정의해 안전한 전용 도구를 만드는 방식 두 가지를 제공합니다. genai-toolbox 에서 이름이 바뀐 프로젝트입니다.
판단
이럴 때 씁니다
- 에이전트나 IDE 를 사내 데이터베이스에 붙이되 연결과 인증을 직접 짜고 싶지 않을 때
- 스키마 탐색이나 조회를 자연어로 시키고 싶을 때
- 운영 에이전트에 노출할 쿼리를 미리 정의해 범위를 좁히고 싶을 때
- 여러 종류의 데이터베이스를 한 서버로 묶고 싶을 때
이럴 땐 쓰지 마세요
- 데이터베이스가 아니라 웹이나 파일을 다뤄야 할 때
- Go 바이너리나 컨테이너를 띄울 수 없는 환경일 때
- 단일 애플리케이션 안에서만 쓰는 쿼리라면 MCP 를 거칠 이유가 없습니다
차별점
- 연결·인증·커넥션 풀을 서버가 대신 맡아 도구마다 다시 짜지 않습니다.
- 바로 쓰는 범용 도구와 직접 정의하는 전용 도구 두 갈래를 함께 제공합니다.
- MCP 클라이언트뿐 아니라 애플리케이션용 SDK 로도 같은 도구를 부릅니다.
- 구글이 관리하며 데이터소스가 릴리스마다 늘고 있습니다.
워크플로
- 01brew install mcp-toolbox 또는 컨테이너로 서버를 준비합니다.
- 02미리 만들어진 범용 도구로 먼저 붙여 스키마를 훑어봅니다.
- 03운영에 쓸 쿼리를 tools 설정에 구조화해 전용 도구로 정의합니다.
- 04MCP 클라이언트에 서버를 등록해 에이전트가 도구를 보게 합니다.
- 05제공되는 SDK 로 애플리케이션 코드에서도 같은 도구를 호출합니다.
주요 명령
| 명령 | 설명 |
|---|---|
brew install mcp-toolbox | macOS 에 서버 바이너리를 설치합니다. |
go install github.com/googleapis/mcp-toolbox@v1.10.0 | Go 로 특정 버전을 설치합니다. |
docker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION | 컨테이너 이미지를 받습니다. |
함정
설치 전에 확인하세요
- genai-toolbox 에서 이름이 바뀌었습니다. 예전 원격 주소를 쓰고 있다면 git remote set-url 로 고쳐야 합니다.
- 범용 도구를 그대로 열면 에이전트가 스키마 전체에 접근합니다. 운영에서는 전용 도구로 범위를 좁히는 편이 안전합니다.
- Secure Parameters 는 아직 Toolbox 실험 확장입니다.
- 구글이 만들지만 클라우드 SQL 전용은 아닙니다. 다만 지원 범위는 데이터소스마다 다릅니다.
비교
직접 MCP SDK 로 DB 서버를 짜면 연결 관리와 자격 증명 처리를 매번 다시 만들게 됩니다. 이쪽은 그 부분을 서버가 떠안고 쿼리 정의만 남깁니다. 대신 지원되는 데이터소스 목록 안에서 움직여야 하므로, 특이한 저장소를 쓰면 SDK 로 직접 만드는 편이 빠릅니다.
최근 변경
2026-08-27 v1.10.0 에서 FalkorDB 소스와 도구가 추가됐고, Secure Parameters 를 Toolbox 실험 확장으로 지원하기 시작했습니다. 서버가 v20260728 규격의 com.google.cloud/toolbox.v1 확장을 받습니다.