mcp-toolbox

KO | EN

gitlite — search

#javascript #react #typescript #android #rust #linux #docker #java #windows #cli #security #ios #mcp #open-source

(★ 16,180)

MCP Toolbox for Databases는 데이터베이스를 위한 오픈 소스 MCP 서버입니다.

mcp-toolbox 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![logo](https://raw.githubusercontent.com/googleapis/mcp-toolbox/main/logo.png)
# MCP Toolbox for Databases
[![googleapis%2Fmcp-toolbox | Trendshift](https://trendshift.io/api/badge/repositories/25495)](https://trendshift.io/repositories/25495)
[![License: Apache
2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Docs](https://img.shields.io/badge/Docs-MCP\_Toolbox-blue)](https://mcp-toolbox.dev/)
[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=flat&logo=discord&logoColor=white)](https://discord.gg/Dmm69peqjh)
[![Medium](https://img.shields.io/badge/Medium-12100E?style=flat&logo=medium&logoColor=white)](https://medium.com/@mcp\_toolbox)
[![Python SDK](https://img.shields.io/pypi/v/toolbox-core?logo=python&logoColor=white&label=Python%20SDK)](https://pypi.org/project/toolbox-core/)
[![JS/TS SDK](https://img.shields.io/npm/v/@toolbox-sdk/core?logo=javascript&logoColor=white&label=JS%20SDK)](https://www.npmjs.com/package/@toolbox-sdk/core)
[![Go SDK](https://img.shields.io/github/v/release/googleapis/mcp-toolbox-sdk-go?logo=go&logoColor=white&label=Go%20SDK)](https://pkg.go.dev/github.com/googleapis/mcp-toolbox-sdk-go)
[![Java SDK](https://img.shields.io/maven-central/v/com.google.cloud.mcp/mcp-toolbox-sdk-java?logo=apache-maven&logoColor=white&label=Java%20SDK)](https://mvnrepository.com/artifact/com.google.cloud.mcp/mcp-toolbox-sdk-java)

MCP Toolbox for Databases는 AI 에이전트, IDE, 애플리케이션을 엔터프라이즈 데이터베이스에 직접 연결해 주는 오픈 소스 Model Context Protocol (MCP) 서버입니다.

![architecture](docs/en/documentation/introduction/architecture.png)

이는 \*\*이중 목적\*\*을 수행합니다:
1. \*\*즉시 사용 가능한 MCP Server (빌드 타임):\*\* 당사의 \*사전 제작된 일반 도구(prebuilt generic tools)\*를 사용하여 Gemini CLI, Google Antigravity, Claude Code, Codex 또는 기타 MCP 클라이언트를 데이터베이스에 즉시 연결할 수 있습니다. 상용구(boilerplate) 코드를 작성할 필요 없이 데이터와 대화하고, 스키마를 탐색하며, 코드를 생성하세요.
2. \*\*커스텀 도구 프레임워크 (런타임):\*\* 프로덕션 에이전트를 위한 특화되고 매우 안전한 AI 도구를 구축할 수 있는 강력한 프레임워크입니다. 구조화된 쿼리, 시맨틱 검색, NL2SQL 기능을 안전하고 쉽게 정의할 수 있습니다.
이 README는 간략한 개요를 제공합니다. 자세한 내용은 [전체 문서](https://mcp-toolbox.dev/)를 참조하세요.
> [!IMPORTANT]
> \*\*저장소 이름 변경 안내:\*\* `genai-toolbox` 저장소의 이름이 공식적으로 `mcp-toolbox`로 변경되었습니다. 로컬 환경에 새 이름이 반영되도록 하려면 원격 저장소 URL을 업데이트할 수 있습니다:
> `git remote set-url origin https://github.com/googleapis/mcp-toolbox.git`
> [!NOTE]
> 이 솔루션은 초기 개발이 MCP보다 먼저 시작되어 원래 “Gen AI Toolbox for Databases” (github.com/googleapis/genai-toolbox)라는 이름이었으나, MCP 호환성에 맞춰 이름이 변경되었습니다.
## 목차
- [왜 MCP Toolbox인가요?](#why-mcp-toolbox)
- [빠른 시작: 사전 제작된 도구 (Prebuilt Tools)](#quick-start-prebuilt-tools)
- [빠른 시작: 커스텀 도구 (Custom Tools)](#quick-start-custom-tools)
- [Toolbox 서버 설치 및 실행](#install--run-the-toolbox-server)
- [Toolbox에 연결하기](#connect-to-toolbox)
- [MCP Client](#mcp-client)
- [Toolbox SDK: 애플리케이션과 통합하기](#toolbox-sdks-integrate-with-your-application)
- [추가 기능](#additional-features)
- [버전 관리](#versioning)
- [기여하기](#contributing)
- [커뮤니티](#community)
---
## 왜 MCP Toolbox인가요?
- \*\*기본 제공되는 데이터베이스 액세스:\*\* IDE 또는 CLI에서 직접 즉시 데이터를 탐색할 수 있는 사전 제작된 일반 도구(`list\_tables`, `execute\_sql` 등)를 제공합니다.
- \*\*커스텀 도구 프레임워크:\*\* 사용자가 미리 정의한 로직으로 프로덕션 수준의 도구를 구축하고, 제한된 액세스(Restricted Access), 구조화된 쿼리, 시맨틱 검색을 통해 안전성을 보장합니다.
- \*\*간소화된 개발:\*\* 10줄 미만의 코드로 Agent Development Kit(ADK), LangChain, LlamaIndex 또는 커스텀 에이전트에 도구를 통합할 수 있습니다.
- \*\*향상된 성능:\*\* 기본적으로 커넥션 풀링, 통합 인증(IAM), 엔드투엔드 관측 가능성(OpenTelemetry)을 처리합니다.
- \*\*향상된 보안\*\* 데이터에 더욱 안전하게 액세스할 수 있는 통합 인증을 제공합니다.
- \*\*엔드투엔드 관측 가능성\*\* OpenTelemetry에 대한 기본 지원을 통해 기본 제공되는 메트릭과 추적(tracing) 기능을 제공합니다.
---
## 빠른 시작: 사전 제작된 도구 (Prebuilt Tools)
컨텍스트 전환을 멈추고 AI 어시스턴트를 진정한 공동 개발자로 만드세요. MCP Toolbox를 사용하여 IDE를 데이터베이스에 연결하면 평문 영어로 데이터를 쿼리하고, 스키마 검색 및 관리를 자동화하며, 데이터베이스 인식 코드를 생성할 수 있습니다.
MCP 서버를 구성하여 MCP 호환 IDE나 클라이언트(예: Gemini CLI, Google Antigravity, Claude Code, Codex 등)에서 Toolbox를 사용할 수 있습니다.
\*\*사전 제작된 도구는 [Google Antigravity MCP Store](https://antigravity.google/docs/mcp)를 통해 간단한 클릭 설치 방식으로 편리하게 이용할 수도 있습니다.\*\*
1. 클라이언트의 MCP 설정 파일(일반적으로 `mcp.json` 또는 `claude\_desktop\_config.json`)에 다음 내용을 추가합니다:
```json
{
"mcpServers": {
"toolbox-postgres": {
"command": "npx",
"args": [
"-y",
"@toolbox-sdk/server",
"--prebuilt=postgres",
"--stdio"
]
}
}
}
```
2. 연결에 필요한 적절한 환경 변수를 설정합니다. 자세한 내용은 [사전 제작된 도구 참조(Prebuilt Tools Reference)](https://mcp-toolbox.dev/documentation/configuration/prebuilt-configs/)를 참조하세요.
`--prebuilt=` 플래그와 함께 Toolbox를 실행하면 해당 데이터베이스와 상호 작용할 수 있는 표준 도구에 즉시 액세스할 수 있습니다. `--prebuilt=/` 구문을 사용하여 특정 도구 세트를 지정할 수도 있습니다(예: SQL 도구만 로드하려면 `--prebuilt=postgres/data`).
현재 지원되는 데이터베이스는 다음과 같습니다:
- \*\*Google Cloud:\*\* AlloyDB, BigQuery, Cloud SQL (PostgreSQL, MySQL, SQL S

erver), Spanner, Firestore, Knowledge Catalog (기존 명칭: Dataplex).
- \*\*기타 데이터베이스:\*\* PostgreSQL, MySQL, [MariaDB](https://mcp-toolbox.dev/integrations/mariadb/source/), SQL Server, Oracle, MongoDB, Redis, Elasticsearch, CockroachDB, ClickHouse, Couchbase, Neo4j, Snowflake, Trino 등.
지원되는 모든 데이터베이스에서 사용할 수 있는 도구 목록과 각 기능에 대한 자세한 내용은 [Prebuilt Tools Reference](https://mcp-toolbox.dev/documentation/configuration/prebuilt-configs/)를 참조하세요.
\*Docker나 바이너리 같은 다양한 실행 방법에 대해서는 [Install & Run the Toolbox server](#install--run-the-toolbox-server) 섹션을 참조하세요.\*
> [!TIP]
> 관리형 솔루션을 찾는 사용자를 위해 [Google Cloud MCP Servers](https://cloud.google.com/blog/products/databases/managed-mcp-servers-for-google-cloud-databases)는
> 사전 구축된 도구가 포함된 관리형 MCP 경험을 제공합니다. [여기에서 차이점에 대해 자세히 알아보세요](https://mcp-toolbox.dev/dev/reference/faq/).
---
## 빠른 시작: 커스텀 도구
Toolbox는 커스텀 도구를 위한 프레임워크로도 사용할 수 있습니다.
Toolbox를 구성하는 주요 방법은 `tools.yaml` 파일을 통하는 것입니다. 파일이
여러 개 있는 경우 `--config tools.yaml` 플래그를 사용하여 Toolbox에 로드할 파일을 지정할 수 있습니다.
모든 리소스 유형에 대한 보다 자세한 참조 문서는
[Resources](https://mcp-toolbox.dev/documentation/configuration/)에서 확인할 수 있습니다.
### 소스
`tools.yaml`의 `sources` 섹션은 Toolbox가 액세스할 수 있는 데이터 소스를 정의합니다. 대부분의 도구는 실행할 소스가 하나 이상 필요합니다.
```yaml
kind: source
name: my-pg-source
type: postgres
host: 127.0.0.1
port: 5432
database: toolbox\_db
user: toolbox\_user
password: my-password
```
다양한 유형의 소스 구성에 대한 자세한 내용은
[Sources](https://mcp-toolbox.dev/documentation/configuration/sources/)를 참조하세요.
### 도구
`tools.yaml`의 `tools` 섹션은 에이전트가 수행할 수 있는 작업(도구 유형, 영향을 미치는 소스, 사용하는 매개변수 등)을 정의합니다.
```yaml
kind: tool
name: search-hotels-by-name
type: postgres-sql
source: my-pg-source
description: Search for hotels based on name.
parameters:
- name: name
type: string
description: The name of the hotel.
statement: SELECT \* FROM hotels WHERE name ILIKE '%' || $1 || '%';
```
다양한 유형의 도구 구성에 대한 자세한 내용은
[Tools](https://mcp-toolbox.dev/documentation/configuration/tools/)를 참조하세요.
### 툴셋
`tools.yaml`의 `toolsets` 섹션을 사용하면 함께 로드하려는 도구 그룹을 정의할 수 있습니다. 이는 에이전트나 애플리케이션에 따라 다양한 그룹을 정의하는 데 유용할 수 있습니다.
```yaml
kind: toolset
name: my\_first\_toolset
tools:
- my\_first\_tool
- my\_second\_tool
---
kind: toolset
name: my\_second\_toolset
tools:
- my\_second\_tool
- my\_third\_tool
```
### 프롬프트
`tools.yaml`의 `prompts` 섹션은 LLM과의 상호작용에 사용할 수 있는 프롬프트를 정의합니다.
```yaml
kind: prompt
name: code\_review
description: "Asks the LLM to analyze code quality and suggest improvements."
messages:
- content: >
Please review the following code for quality, correctness,
and potential improvements: \n\n{{.code}}
arguments:
- name: "code"
description: "The code to review"
```
프롬프트 구성에 대한 자세한 내용은
[Prompts](https://mcp-toolbox.dev/documentation/configuration/prompts/)를 참조하세요.
---
## Toolbox 서버 설치 및 실행
[구성 파일](#quick-start-custom-tools)을 사용하여 Toolbox를 직접 실행할 수 있습니다.
```sh
npx @toolbox-sdk/server --config tools.yaml
```
이렇게 하면 구성 파일과 함께 최신 버전의 Toolbox 서버가 실행됩니다.
> [!NOTE]
> 이 방법은 성능보다는 편의성을 위해 최적화되어 있습니다.
> 보다 표준적이고 신뢰할 수 있는 설치를 원하시는 경우, [Install & Run the Toolbox server](#install--run-the-toolbox-server)에 설명된 대로 바이너리나 컨테이너 이미지를 사용해 주세요.
### Toolbox 설치
최신 버전을 확인하려면 [릴리스 페이지][releases]를 확인하고 다음을 사용하세요.

사용 중인 OS 및 CPU 아키텍처에 맞는 지침을 확인하세요.
[releases]: https://github.com/googleapis/mcp-toolbox/releases
Binary
Toolbox를 바이너리 형태로 설치하려면:
> 
> Linux (AMD64)
>
> Linux (AMD64)에 Toolbox를 바이너리 형태로 설치하려면:
>
> ```sh
> # see releases page for other versions
> export VERSION=1.9.0
> curl -L -o toolbox https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/linux/amd64/toolbox
> chmod +x toolbox
> ```
>
> 
> 
> macOS (Apple Silicon)
>
> macOS (Apple Silicon)에 Toolbox를 바이너리 형태로 설치하려면:
>
> ```sh
> # see releases page for other versions
> export VERSION=1.9.0
> curl -L -o toolbox https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/darwin/arm64/toolbox
> chmod +x toolbox
> ```
>
> 
> 
> macOS (Intel)
>
> macOS (Intel)에 Toolbox를 바이너리 형태로 설치하려면:
>
> ```sh
> # see releases page for other versions
> export VERSION=1.9.0
> curl -L -o toolbox https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/darwin/amd64/toolbox
> chmod +x toolbox
> ```
>
> 
> 
> Windows (Command Prompt)
>
> Windows (Command Prompt)에 Toolbox를 바이너리 형태로 설치하려면:
>
> ```cmd
> :: see releases page for other versions
> set VERSION=1.9.0
> curl -o toolbox.exe "https://storage.googleapis.com/mcp-toolbox-for-databases/v%VERSION%/windows/amd64/toolbox.exe"
> ```
>
> 
> 
> Windows (PowerShell)
>
> Windows (PowerShell)에 Toolbox를 바이너리 형태로 설치하려면:
>
> ```powershell
> # see releases page for other versions
> $VERSION = "1.9.0"
> curl.exe -o toolbox.exe "https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/windows/amd64/toolbox.exe"
> ```
>
> 
> 
> Windows ARM64 (Command Prompt)
>
> Windows ARM64 (Command Prompt)에 Toolbox를 바이너리 형태로 설치하려면:
>
> ```cmd
> :: see releases page for other versions
> set VERSION=1.9.0
> curl -o toolbox.exe "https://storage.googleapis.com/mcp-toolbox-for-databases/v%VERSION%/windows/arm64/toolbox.exe"
> ```
>
> 
> 
> Windows ARM64 (PowerShell)
>
> Windows ARM64 (PowerShell)에 Toolbox를 바이너리 형태로 설치하려면:
>
> ```powershell
> # see releases page for other versions
> $VERSION = "1.9.0"
> curl.exe -o toolbox.exe "https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/windows/arm64/toolbox.exe"
> ```

Container image
Toolbox를 컨테이너로 설치할 수도 있습니다:
```sh
# 다른 버전은 릴리스 페이지를 참고하세요
export VERSION=1.9.0
docker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION
```

Homebrew
macOS 또는 Linux에서 Homebrew를 사용하여 Toolbox를 설치하려면 다음을 실행하세요:
```sh
brew install mcp-toolbox
```

소스 코드에서 컴파일
소스에서 설치하려면 최신 버전의 [Go가 설치되어 있는지](https://go.dev/doc/install) 확인한 후 다음 명령어를 실행하세요:
```sh
go install github.com/googleapis/mcp-toolbox@v1.9.0
```

Gemini CLI
[Gemini CLI extensions](https://geminicli.com/extensions/)를 확인하여 AlloyDB, BigQuery, Cloud SQL 같은 특정 데이터베이스용 미리 빌드된 도구를 Gemini CLI에 직접 설치할 수 있습니다.
```sh
# Install Gemini CLI
npm install -g @google/gemini-cli
# Install the extension
gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-postgres
# Run Gemini CLI
gemini
```
Gemini CLI를 통해 자연어로 커스텀 도구와 상호작용하세요.
```sh
# Install the extension
gemini extensions install https://github.com/gemini-cli-extensions/mcp-toolbox
```
### Toolbox 실행
도구를 정의할 `tools.yaml`을 [구성](#quick-start-custom-tools)한 다음, `toolbox`를 실행하여 서버를 시작합니다:
Binary
바이너리에서 Toolbox를 실행하려면:
```sh
./toolbox --config "tools.yaml"
```
> ⓘ 참고
> Toolbox는 기본적으로 동적 새로 고침을 활성화합니다. 비활성화하려면 `--disable-reload` 플래그를 사용하세요.

Container image
[컨테이너 이미지](#install-toolbox)를 풀한 후 서버를 실행하려면:
```sh
export VERSION=0.24.0 # Use the version you pulled
docker run -p 5000:5000 \
-v $(pwd)/tools.yaml:/app/tools.yaml \
us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION \
--config "/app/tools.yaml"
```
> ⓘ 참고
> `-v` 플래그는 로컬 `tools.yaml`을 컨테이너 내부로 마운트하고, `-p`는 컨테이너의 포트 `5000`을 호스트의 포트 `5000`에 매핑합니다.

Source
소스에서 직접 서버를 실행하려면 프로젝트 루트 디렉터리로 이동하여 다음을 실행하세요:
```sh
go run .
```
> ⓘ 참고
> 이 명령어는 소스에서 직접 프로젝트를 실행하며 개발 및 테스트에 더 적합합니다. 바이어리를 `$GOPATH`에 컴파일하지 \*\*않습니다\__. 대신바이너리를컴파일하려면[Developer Documentation](./DEVELOPER.md#building-the-binary)를참고하세요.

Homebrew
[Homebrew](https://brew.sh/)를 사용하여 Toolbox를 설치한 경우, `toolbox` 바이너리를시스템패스에서사용할수있습니다.동일한명령어로서버를시작할수있습니다:
```sh
toolbox --config "tools.yaml"
```

NPM
바이릴를수동으로다운로드하지않고Toolbox를직접실행하려면(Node.js필요):
```sh
npx @toolbox-sdk/server --config tools.yaml
```

Gemini CLI
[Gemini CLI extensions](https://geminicli.com/extensions/)을 설치하면 사용 중에 사전 빌드된 도구를 사용할 수 있습니다.
```sh
# Run Gemini CLI
gemini
# List extensions
/extensions list
# List MCP servers
/mcp list
```
전체 플래그 목록을 보려면 `toolbox help`를 사용할 수 있습니다! 서버를 중지하려면 종료 신호(`ctrl+c` 또는 대부분의 플랫폼)를 보내세요.
다양한 환경에 배포하는 방법에 대한 자세한 문서는 [Deploy Toolbox 섹션](https://mcp-toolbox.dev/documentation/deploy-to/)의 리소스를 확인하세요.
---
## Connect to Toolbox
Toolbox 서버가 실행되면 MCP 호환 클라이언트나 애플리케이션에 도구를 로드할 수 있습니다.
### MCP Client
MCP 클라이언트 구성에 다음 설정을 추가하세요.
```json
{
"mcpServers": {
"toolbox": {
"type": "http",
"url": "http://127.0.0.1:5000/mcp",
}
}
}
```
특정 툴셋에 연결하려면 url을 "http://127.0.0.1:5000/mcp/{toolset\_name}"으로 바꾸세요.
### Toolbox SDKs: Integrate with your Application
Toolbox Client SDK는 사용자 정의 애플리케이션을 MCP Toolbox 서버에 연결하기 위한 사용하기 쉬운 빌딩 블록과 고급 기능을 제공합니다. 다양한 프레임워크를 사용하기 위한 Client SDK 목록은 아래를 참고하세요.
Python ([Github](https://github.com/googleapis/mcp-toolbox-sdk-python))
  
> Core
> 1. [Toolbox Core SDK][toolbox-core] 설치하기:
> ```bash
> pip install toolbox-core
> ```
> 1. 도구 로드하기:
> ```python
> from toolbox\_core import ToolboxClient
> # update the url to point to your server
> async with ToolboxClient("http://127.0.0.1:5000") as client:
> # these tools can be passed to your application!
> tools = await client.load\_toolset("toolset\_name")
> ```
> Toolbox Core SDK 사용에 대한 자세한 지침은 [프로젝트의 README][toolbox-core-readme]를 참조하세요.
> [toolbox-core]: https://pypi.org/project/toolbox-core/
> [toolbox-core-readme]: https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-core/README.md
>
> LangChain / LangGraph
> 1. [Toolbox LangChain SDK][toolbox-langchain] 설치하기:
> ```bash
> pip install toolbox-langchain
> ```
> 1. 도구 로드하기:
> ```python
> from toolbox\_langchain import ToolboxClient
> # update the url to point to your server
> async with ToolboxClient("http://127.0.0.1:5000") as client:
> # these tools can be passed to your application!
> tools = client.load\_toolset()
> ```
> Toolbox LangChain SDK 사용에 대한 자세한 지침은 [프로젝트의 README][toolbox-langchain-readme]를 참조하세요.
> [toolbox-langchain]: https://pypi.org/project/toolbox-langchain/
> [toolbox-langchain-readme]: https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-langchain/README.md
>
> LlamaIndex
> 1. [Toolbox Llamaindex SDK][toolbox-llamaindex] 설치하기:
> ```bash
> pip install toolbox-llamaindex
> ```
> 1. 도구 로드하기:
> ```python
> from toolbox\_llamaindex import ToolboxClient
> # update the url to point to your server
> async with ToolboxClient("http://127.0.0.1:5000") as client:
> # these tools can be passed to your application!
> tools = client.load\_toolset()
> ```
> Toolbox Llamaindex SDK 사용에 대한 자세한 지침은 [프로젝트의 README][toolbox-llamaindex-readme]를 참조하세요.
> [toolbox-llamaindex]: https://pypi.org/project/toolbox-llamaindex/
> [toolbox-llamaindex-readme]: https://github.com/googleapis/genai-toolbox-llamaindex-python/blob/main/README.md

Javascript/Typescript ([Github](https://github.com/googleapis/mcp-toolbox-sdk-js))
  
> Core
> 1. [Toolbox Core SDK][toolbox-core-js] 설치:
> ```bash
> npm install @toolbox-sdk/core
> ```
> 1. 도구 로드:
> ```javascript
> import { ToolboxClient } from '@toolbox-sdk/core';
> // update the url to point to your server
> const URL = 'http://127.0.0.1:5000';
> let client = new ToolboxClient(URL);
> // these tools can be passed to your application!
> const tools = await client.loadToolset('toolsetName');
> ```
> Toolbox Core SDK 사용에 대한 자세한 지침은 [프로젝트 README][toolbox-core-js-readme]를 참조하세요.
> [toolbox-core-js]: https://www.npmjs.com/package/@toolbox-sdk/core
> [toolbox-core-js-readme]: https://github.com/googleapis/mcp-toolbox-sdk-js/blob/main/packages/toolbox-core/README.md
>
> LangChain / LangGraph
> 1. [Toolbox Core SDK][toolbox-core-js] 설치:
> ```bash
> npm install @toolbox-sdk/core
> ```
> 2. 도구 로드:
> ```javascript
> import { ToolboxClient } from '@toolbox-sdk/core';
> // update the url to point to your server
> const URL = 'http://127.0.0.1:5000';
> let client = new ToolboxClient(URL);
> // these tools can be passed to your application!
> const toolboxTools = await client.loadToolset('toolsetName');
> // Define the basics of the tool: name, description, schema and core logic
> const getTool = (toolboxTool) => tool(currTool, {
> name: toolboxTool.getName(),
> description: toolboxTool.getDescription(),
> schema: toolboxTool.getParamSchema()
> });
> // Use these tools in your Langchain/Langraph applications
> const tools = toolboxTools.map(getTool);
> ```
>
> Genkit
> 1. [Toolbox Core SDK][toolbox-core-js] 설치:
> ```bash
> npm install @toolbox-sdk/core
> ```
> 2. 도구 로드:
> ```javascript
> import { ToolboxClient } from '@toolbox-sdk/core';
> import { genkit } from 'genkit';
> // Initialise genkit
> const ai = genkit({
> plugins: [
> googleAI({
> apiKey: process.env.GEMINI\_API\_KEY || process.env.GOOGLE\_API\_KEY
> })
> ],
> model: googleAI.model('gemini-2.0-flash'),
> });
> // update the url to point to your server
> const URL = 'http://127.0.0.1:5000';
> let client = new ToolboxClient(URL);
> // these tools can be passed to your application!
> const toolboxTools = await client.loadToolset('toolsetName');
> // Define the basics of the tool: name, description, schema and core logic
> const getTool = (toolboxTool) => ai.defineTool({
> name: toolboxTool.getName(),
> description: toolboxTool.getDescription(),
> schema: toolboxTool.getParamSchema()
> }, toolboxTool)
> // Use these tools in your Genkit applications
> const tools = toolboxTools.map(getTool);
> ```
>
> ADK
> 1. [Toolbox ADK SDK][toolbox-adk-js] 설치:
> ```bash
> npm install @toolbox-sdk/adk
> ```
> 2. 도구 로드:
> ```javascript
> import { ToolboxClient } from '@toolbox-sdk/adk';
> // update the url to point to your server
> const URL = 'http://127.0.0.1:5000';
> let client = new ToolboxClient(URL);
> // these tools can be passed to your application!
> const tools = await client.loadToolset('toolsetName');
> ```
> Toolbox ADK SDK 사용에 대한 자세한 지침은 [프로젝트 README][toolbox-adk-js-readme]를 참조하세요.
> [toolbox-adk-js]: https://www.npmjs.com/package/@toolbox-sdk/adk
> [toolbox-adk-js-readme]:
> https://github.com/googleapis/mcp-toolbox-sdk-js/blob/main/packages/toolbox-adk/README.md

Go ([Github](https://github.com/googleapis/mcp-toolbox-sdk-go))
  
> Core
> 1. [Toolbox Go SDK][toolbox-go] 설치하기:
> ```bash
> go get github.com/googleapis/mcp-toolbox-sdk-go
> ```
> 2. 도구 로드하기:
> ```go
> package main
> import (
> "github.com/googleapis/mcp-toolbox-sdk-go/core"
> "context"
> )
> func main() {
> // Make sure to add the error checks
> // update the url to point to your server
> URL := "http://127.0.0.1:5000";
> ctx := context.Background()
> client, err := core.NewToolboxClient(URL)
> // Framework agnostic tools
> tools, err := client.LoadToolset("toolsetName", ctx)
> }
> ```
> Toolbox Go SDK 사용에 대한 자세한 내용은 
> [프로젝트의 README][toolbox-core-go-readme]를 참조하세요.
> [toolbox-go]: https://pkg.go.dev/github.com/googleapis/mcp-toolbox-sdk-go/core
> [toolbox-core-go-readme]: https://github.com/googleapis/mcp-toolbox-sdk-go/blob/main/core/README.md
>
> LangChain Go
> 1. [Toolbox Go SDK][toolbox-go] 설치하기:
> ```bash
> go get github.com/googleapis/mcp-toolbox-sdk-go
> ```
> 2. 도구 로드하기:
> ```go
> package main
> import (
> "context"
> "encoding/json"
> "github.com/googleapis/mcp-toolbox-sdk-go/core"
> "github.com/tmc/langchaingo/llms"
> )
> func main() {
> // Make sure to add the error checks
> // update the url to point to your server
> URL := "http://127.0.0.1:5000"
> ctx := context.Background()
> client, err := core.NewToolboxClient(URL)
> // Framework agnostic tool
> tool, err := client.LoadTool("toolName", ctx)
> // Fetch the tool's input schema
> inputschema, err := tool.InputSchema()
> var paramsSchema map[string]any
> \_ = json.Unmarshal(inputschema, &paramsSchema)
> // Use this tool with LangChainGo
> langChainTool := llms.Tool{
> Type: "function",
> Function: &llms.FunctionDefinition{
> Name: tool.Name(),
> Description: tool.Description(),
> Parameters: paramsSchema,
> },
> }
> }
> ```
>
> Genkit
> 1. [Toolbox Go SDK][toolbox-go] 설치하기:
> ```bash
> go get github.com/googleapis/mcp-toolbox-sdk-go
> ```
> 2. 도구 로드하기:
> ```go
> package main
> import (
> "context"
> "log"
> "github.com/firebase/genkit/go/genkit"
> "github.com/googleapis/mcp-toolbox-sdk-go/core"
> "github.com/googleapis/mcp-toolbox-sdk-go/tbgenkit"
> )
> func main() {
> // Make sure to add the error checks
> // Update the url to point to your server
> URL := "http://127.0.0.1:5000"
> ctx := context.Background()
> g := genkit.Init(ctx)
> client, err := core.NewToolboxClient(URL)
> // Framework agnostic tool
> tool, err := client.LoadTool("toolName", ctx)
> // Convert the tool using the tbgenkit package
> // Use this tool with Genkit Go
> genkitTool, err := tbgenkit.ToGenkitTool(tool, g)
> if err != nil {
> log.Fatalf("Failed to convert tool: %v\n", err)
> }
> log.Printf("Successfully converted tool: %s", genkitTool.Name())
> }
> ```
>
> Go GenAI
> 1. [Toolbox Go SDK][toolbox-go] 설치하기:
> ```bash
> go get github.com/googleapis/mcp-toolbox-sdk-go
> ```
> 2. 도구 로드하기:
> ```go
> package main
> import (
> "context"
> "encoding/json"
> "github.com/googleapis/mcp-toolbox-sdk-go/core"
> "google.golang.org/genai"
> )
> func main() {
> // Make sure to add the error checks
> // Update the url to point to your server
> URL := "http://127.0.0.1:5000"
> ctx := context.Background()
> client, err := core.NewToolboxClient(URL)
> // Framework agnostic tool
> tool, err := client.LoadTool("toolName", ctx)
> // Fetch the tool's input schema
> inputschema, err := tool.InputSchema()
> var schema \*genai.Schema
> \_ = json.Unmarshal(inputschema, &schema)
> funcDeclaration := &genai.FunctionDeclaration{
> Name: tool.Name(),
> Description: tool.Description(),
> Parameters: schema,
> }
> // Use this tool with Go GenAI
> genAITool := &genai.Tool{
> FunctionDeclarations: []\*genai.FunctionDeclaration{funcDeclaration},
> }
> }
> ```
>
> OpenAI Go
> 1. [Toolbox Go SDK][toolbox-go] 설치하기:
> ```bash
> go get github.com/googleapis/mcp-toolbox-sdk-go
> ```
> 2. 도구 로드하기:
> ```go
> package main
> import (
> "context"
> "encoding/json"

"github.com/googleapis/mcp-toolbox-sdk-go/core"
> openai "github.com/openai/openai-go"
> )
> func main() {
> // 에러 처리를 반드시 추가하세요
> // 서버를 가리키도록 URL을 업데이트하세요
> URL := "http://127.0.0.1:5000"
> ctx := context.Background()
> client, err := core.NewToolboxClient(URL)
> // 프레임워크에 구애받지 않는 도구
> tool, err := client.LoadTool("toolName", ctx)
> // 도구의 입력 스키마 가져오기
> inputschema, err := tool.InputSchema()
> var paramsSchema openai.FunctionParameters
> \_ = json.Unmarshal(inputschema, &paramsSchema)
> // OpenAI Go와 함께 이 도구 사용
> openAITool := openai.ChatCompletionToolParam{
> Function: openai.FunctionDefinitionParam{
> Name: tool.Name(),
> Description: openai.String(tool.Description()),
> Parameters: paramsSchema,
> },
> }
> }
> ```
>
> ADK Go
> 1. [Toolbox Go SDK][toolbox-go] 설치:
> ```bash
> go get github.com/googleapis/mcp-toolbox-sdk-go
> ```
> 1. 도구 로드:
> ```go
> package main
> import (
> "github.com/googleapis/mcp-toolbox-sdk-go/tbadk"
> "context"
> )
> func main() {
> // 에러 처리를 반드시 추가하세요
> // 서버를 가리키도록 URL을 업데이트하세요
> URL := "http://127.0.0.1:5000"
> ctx := context.Background()
> client, err := tbadk.NewToolboxClient(URL)
> if err != nil {
> return fmt.Sprintln("Toolbox 클라이언트를 시작할 수 없습니다", err)
> }
> // ADK Go와 함께 이 도구 사용
> tool, err := client.LoadTool("toolName", ctx)
> if err != nil {
> return fmt.Sprintln("Toolbox 도구를 로드할 수 없습니다", err)
> }
> }
> ```
> Toolbox Go SDK 사용에 대한 더 자세한 지침은
> [프로젝트의 README][toolbox-core-go-readme]를 참조하세요.

---
## 추가 기능
### Toolbox UI로 툴 테스트하기
Toolbox의 대화형 UI를 실행하려면 `--ui` 플래그를 사용하세요. 이를 통해 승인된 파라미터 등의 기능을 사용하여 툴과 툴셋을 테스트할 수 있습니다. 자세한 내용은 [Toolbox UI](https://mcp-toolbox.dev/documentation/configuration/toolbox-ui/)를 방문하여 확인하세요.
```sh
./toolbox --ui
```
### 텔레메트리(Telemetry)
Toolbox는 OpenTelemetry를 통해 추적(trace)과 메트릭을 출력합니다. Google Cloud Monitoring, Agnost AI 또는 기타 OTLP 호환 백엔드로 내보내려면 `--telemetry-otlp=`를 사용하세요. 자세한 내용은 [텔레메트리 문서](https://mcp-toolbox.dev/documentation/monitoring/export\_telemetry/)를 참조하세요.
### 에이전트 스킬 생성
`skills-generate` 명령어를 사용하면 **툴셋(toolset)**을 [Agent Skill 사양](https://agentskills.io/specification)과 호환되는 **에이전트 스킬(Agent Skill)**로 변환할 수 있습니다. 이는 툴을 이포터블 스킬 패키지로 배포할 때 유용합니다.
```bash
toolbox --config tools.yaml skills-generate \
--name "my-skill" \
--toolset "my\_toolset" \
--description "A skill containing multiple tools"
```
생성된 스킬은 Gemini CLI에 설치할 수 있습니다.
```bash
gemini skills install ./skills/my-skill
```
자세한 내용은 [에이전트 스킬 생성 가이드](https://mcp-toolbox.dev/documentation/configuration/skills/)를 참조하세요.
이 저장소에는 바로 사용할 수 있는 에이전트 스킬(예: 메인테이너 워크플로)도 함께 제공됩니다. 카탈로그 및 설치 지침은 [`skills/`](./skills/README.md)를 참조하세요.
---
## 버전 관리
MCP Toolbox for Databases는 [시맨틱 버저닝(Semantic Versioning)](https://semver.org/)을 따릅니다.
공개 API에는 Toolbox 서버(CLI, 설정 매니페스트, 사전 구축된 툴셋)와 클라이언트 SDK가 포함됩니다.
- **주요 버전(Major versions)**은 호환되지 않는 CLI 또는 매니페스트 변경 사항과 같은 호환성이 깨지는 변경이 있을 때 증가합니다.
- **부 버전(Minor versions)**은 사전 구축된 툴셋 수정이나 베타 기능을 포함한 새로운 기능이 추가될 때 증가합니다.
- **패치 버전(Patch versions)**은 하위 호환되는 버그 수정 시 증가합니다.
자세한 내용은 [전체 버전 관리 정책](https://mcp-toolbox.dev/reference/versioning/)을 참조하세요.
---
## 기여하기
기여를 환영합니다. 시작하려면 [CONTRIBUTING](CONTRIBUTING.md) 가이드를 참조하세요.
Toolbox 자체를 개발하기 위한 환경 설정에 대한 기술적 세부 정보는 [DEVELOPER](DEVELOPER.md) 가이드를 참조하세요.
이 프로젝트는 기여자 행동 강령(Contributor Code of Conduct)에 따라 배포됩니다. 이 프로젝트에 참여함으로써 귀하는 해당 약관을 준수하는 데 동의하게 됩니다. 자세한 내용은 [기여자 행동 강령](CODE\_OF\_CONDUCT.md)을 참조하세요.
---
## 커뮤니티
개발자들과 소통하려면 [Discord 커뮤니티](https://discord.gg/GQrFB3Ec3W)에 참여하세요!

mcp-toolbox

mcp-toolbox 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

mcp-toolbox

mcp-toolbox 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README