Overview
MCP Toolbox for Databases는 데이터베이스를 위한 오픈 소스 MCP server입니다. 엔터프라이즈급 및 프로덕션 품질을 염두에 두고 설계되었습니다. connection pooling, authentication 등의 복잡한 작업을 처리하여 더 쉽고, 빠르고, 안전하게 tool을 개발할 수 있습니다. Toolbox Tools는 LangChain application과 원활하게 통합될 수 있습니다. MCP Toolbox 시작하기 또는 구성에 대한 자세한 내용은 문서를 참조하세요.
Setup
이 가이드는 이미 다음 작업을 완료했다고 가정합니다:1. Setup your Database
먼저 PostgreSQL database를 설정하겠습니다. 새 database, MCP Toolbox 전용 user, 그리고 샘플 데이터가 포함된hotels table을 생성합니다.
psql 명령을 사용하여 PostgreSQL에 연결합니다. PostgreSQL 설정에 따라 명령을 조정해야 할 수 있습니다(예: host를 지정하거나 다른 superuser를 사용해야 하는 경우).
hotels table을 생성하고 데이터를 삽입합니다:
\q를 입력하여 psql을 종료할 수 있습니다.
2. Install MCP Toolbox
다음으로 MCP Toolbox를 설치하고,tools.yaml 구성 파일에 tool을 정의한 다음, MCP Toolbox server를 실행합니다.
macOS 사용자의 경우 Homebrew로 설치하는 것이 가장 쉽습니다:
tools.yaml 파일을 생성합니다. 이 파일은 MCP Toolbox가 연결할 수 있는 data source와 agent에 노출할 수 있는 tool을 정의합니다. 프로덕션 환경에서는 항상 secret에 environment variable을 사용하세요.
toolbox를 실행하면 됩니다. binary를 수동으로 다운로드한 경우 저장한 디렉토리에서 ./toolbox를 실행해야 합니다:
http://127.0.0.1:5000에서 시작되며 tools.yaml 파일을 변경하면 hot-reload됩니다.
Instantiation
Invocation
Use within an agent
이제 재미있는 부분입니다! 필요한 LangChain package를 설치하고 MCP Toolbox에서 정의한 tool을 사용할 수 있는 agent를 생성합니다.ChatVertexAI를 사용하고 tool을 로드하기 위해 ToolboxClient를 사용합니다. langchain.agents의 create_agent는 어떤 tool을 호출할지 추론할 수 있는 강력한 agent를 생성합니다.
참고: 아래 코드를 실행하기 전에 별도의 terminal에서 MCP Toolbox server가 실행 중인지 확인하세요.
Run the agent
API reference
이 통합의 주요 class는ToolboxClient입니다.
자세한 내용은 다음 리소스를 참조하세요:
MCP Toolbox는 데이터베이스용 Gen AI tool 개발을 원활하게 만드는 다양한 기능을 제공합니다:
- Authenticated Parameters: tool input을 OIDC token의 값에 자동으로 바인딩하여 데이터 유출 가능성 없이 민감한 query를 쉽게 실행할 수 있습니다
- Authorized Invocations: 사용자의 Auth token을 기반으로 tool 사용 액세스를 제한합니다
- OpenTelemetry: OpenTelemetry를 통해 MCP Toolbox에서 metric 및 tracing을 가져옵니다
Community and Support
커뮤니티에 참여하시기를 권장합니다:- ⭐️ GitHub repository로 이동하여 시작하고 업데이트를 확인하세요.
- 📚 더 고급 기능 및 구성에 대해서는 공식 문서를 살펴보세요.
- 💬 Discord server에 참여하여 커뮤니티와 소통하고 질문하세요.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.