Repolode
googleapis

googleapis/mcp-toolbox

사전 구축 도구나 사용자 정의 도구 정의로 AI 에이전트, IDE, 앱을 데이터베이스에 연결하는 오픈소스 MCP 서버입니다.

스타
16,681
포크
1,765
열린 이슈
396
마지막 커밋
3일 전

어떤 프로젝트인가요?

MCP Toolbox for Databases는 AI 에이전트, IDE 어시스턴트, 애플리케이션이 데이터베이스에 접근할 수 있게 해주는 오픈소스 Model Context Protocol 서버입니다. --prebuilt=postgres처럼 데이터베이스에 맞는 사전 구축 플래그를 지정해 실행하면 Gemini CLI, Claude Code, Codex 같은 MCP 클라이언트에서 테이블 조회, SQL 실행, 스키마 탐색을 위한 범용 도구를 사용할 수 있습니다.

프로덕션 환경에서는 사용자 정의 도구를 위한 프레임워크로도 활용할 수 있습니다. 개발자는 매개변수화된 SQL 문과 제한된 접근 권한을 포함해 tools.yaml 파일에 소스, 도구, 도구 세트, 프롬프트, 리소스를 정의합니다. Python, JavaScript/TypeScript, Go, Java용 클라이언트 SDK를 사용하면 LangChain, LlamaIndex, Genkit, ADK 같은 프레임워크에 이러한 도구를 불러올 수 있습니다.

이 서버는 PostgreSQL, MySQL, BigQuery, Spanner, MongoDB, Redis, Elasticsearch, ClickHouse를 비롯한 다양한 데이터베이스를 지원합니다. 연결 풀링, IAM 기반 인증, OpenTelemetry 메트릭 및 트레이싱을 제공하며, 도구를 테스트할 수 있는 내장 UI도 포함합니다.

핵심 기능

  • 01MCP 호환 IDE와 CLI에서 사용할 수 있는 인기 데이터베이스용 사전 구축 범용 도구
  • 02매개변수화된 SQL, 도구 세트, 프롬프트를 포함하는 YAML 기반 사용자 정의 도구 정의
  • 03Python, JavaScript/TypeScript, Go, Java용 클라이언트 SDK
  • 04IAM 통합 인증 및 연결 풀링
  • 05OpenTelemetry 메트릭 및 트레이싱 내보내기
  • 06도구와 도구 세트를 테스트하는 대화형 UI

활용 사례

  • AI 코딩 어시스턴트가 PostgreSQL 또는 MySQL 스키마를 탐색하고 데이터베이스 구조를 고려한 코드를 작성하도록 지원
  • 프로덕션 에이전트에 데이터베이스 전체 접근 권한 대신 제한된 매개변수화 SQL 도구를 제공
  • LangChain 또는 LlamaIndex 에이전트를 BigQuery나 Spanner 데이터에 연결
  • 이름이 지정된 도구 세트를 통해 여러 에이전트에 데이터베이스 조회 기능 제공

빠른 시작

  1. 1

    MCP 클라이언트 설정에 Toolbox 서버를 추가하세요

  2. 2

    설정 파일을 사용해 Toolbox 서버를 실행하세요

    npx @toolbox-sdk/server --config tools.yaml

사용 전 알아둘 점

  • 데이터베이스에 연결하려면 연결 환경 변수 또는 설정 파일을 설정해야 합니다.
  • npx를 통한 실행은 성능보다 편의성에 최적화되어 있습니다. 프로덕션 환경에서는 바이너리 또는 컨테이너를 사용하는 것이 좋습니다.

토픽

자주 묻는 질문

mcp-toolbox은(는) 무엇인가요?
사전 구축 도구나 사용자 정의 도구 정의로 AI 에이전트, IDE, 앱을 데이터베이스에 연결하는 오픈소스 MCP 서버입니다. MCP Toolbox for Databases는 AI 에이전트, IDE 어시스턴트, 애플리케이션이 데이터베이스에 접근할 수 있게 해주는 오픈소스 Model Context Protocol 서버입니다. --prebuilt=postgres처럼 데이터베이스에 맞는 사전 구축 플래그를 지정해 실행하면 Gemini CLI, Claude Code, Codex 같은 MCP 클라이언트에서 테이블 조회, SQL 실행, 스키마 탐색을 위한 범용 도구를 사용할 수 있습니다.
mcp-toolbox은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
mcp-toolbox은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
mcp-toolbox은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. mcp-toolbox의 마지막 커밋은 2026년 10월 17일입니다.
mcp-toolbox은(는) 어디에 사용할 수 있나요?
AI 코딩 어시스턴트가 PostgreSQL 또는 MySQL 스키마를 탐색하고 데이터베이스 구조를 고려한 코드를 작성하도록 지원 프로덕션 에이전트에 데이터베이스 전체 접근 권한 대신 제한된 매개변수화 SQL 도구를 제공 LangChain 또는 LlamaIndex 에이전트를 BigQuery나 Spanner 데이터에 연결 이름이 지정된 도구 세트를 통해 여러 에이전트에 데이터베이스 조회 기능 제공
mcp-toolbox는 어떻게 설치하나요?
MCP 클라이언트 설정에 Toolbox 서버를 추가하세요 설정 파일을 사용해 Toolbox 서버를 실행하세요: npx @toolbox-sdk/server --config tools.yaml
mcp-toolbox은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/googleapis/mcp-toolbox

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트