IDE에서 MCP 도구 상자를 사용하여 AlloyDB 데이터베이스 만들기

이 페이지에서는 데이터베이스용 MCP Toolbox를 사용하여 통합 개발 환경(IDE)에서 PostgreSQL용 AlloyDB 클러스터와 인스턴스를 만들고 관리하는 방법을 설명합니다. 모델 컨텍스트 프로토콜(MCP)을 지원하는 개발자 도구를 사용할 수 있습니다.

모델 컨텍스트 프로토콜(MCP)은 대규모 언어 모델(LLM)을 AlloyDB API와 같은 데이터 소스 및 API에 연결하기 위한 개방형 프로토콜입니다. AI 어시스턴트는 IDE에서 LLM 기반 채팅 인터페이스로, 사용자가 목표를 달성하고 작업을 완료하도록 지원합니다. 이 페이지에서는 데이터베이스용 MCP Toolbox를 사용하여 다음 IDE 환경에서 개발자 어시스턴트 도구를 AlloyDB 인스턴스에 연결하는 방법을 설명합니다.

시작하기 전에

  1. Google Cloud 콘솔의 프로젝트 선택 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

  2. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

  3. AlloyDB Admin API를 사용 설정합니다.

    API 사용 설정

필요한 역할

AlloyDB 리소스를 관리하려면 관리자에게 프로젝트에 대해 다음과 같은 Identity and Access Management 역할을 부여해 달라고 요청하세요.

  • AlloyDB 관리자(roles/alloydb.admin)
  • 서비스 사용량 소비자(roles/serviceusage.serviceUsageConsumer)

MCP Toolbox 설치

  1. MCP Toolbox의 최신 버전을 바이너리로 다운로드합니다. 운영체제(OS) 및 CPU 아키텍처에 해당하는 바이너리를 선택합니다. MCP Toolbox 버전 V0.10.0 이상을 사용해야 합니다.

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/linux/amd64/toolbox

    darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/darwin/arm64/toolbox

    darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/darwin/amd64/toolbox

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/v0.10.0/windows/amd64/toolbox

  2. 바이너리를 실행 파일로 만듭니다.

    chmod +x toolbox

  3. 설치를 확인합니다.

    ./toolbox --version

MCP 클라이언트 구성

IDE를 구성하여 컨트롤 플레인 도구를 사용해 AlloyDB 클러스터와 인스턴스를 만들고 관리할 수 있습니다. 이미 AlloyDB 인스턴스가 있는 경우 이 단계를 건너뛰고 MCP Toolbox를 사용해 IDE를 PostgreSQL용 AlloyDB에 연결로 이동하세요. 인스턴스는 지정된 컨트롤 플레인 도구를 사용하여 공개 IP 주소로 생성됩니다. IDE의 MCP 설정 파일에 다음 구성을 추가합니다. 이 방식은 alloydb-postgres-admin 도구를 AI 어시스턴트에 노출합니다.

Claude Code

  1. Claude Code를 설치합니다.
  2. 프로젝트 루트에 .mcp.json 파일이 없으면 만듭니다.
  3. gcloud auth print-access-token을 실행하여 API_KEY로 사용할 액세스 토큰을 생성합니다.
  1. 다음 구성을 추가하고 API_KEY를 생성한 토큰으로 바꾼 후 저장합니다.
{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Claude Desktop

  1. Claude Desktop을 열고 설정으로 이동합니다.
  2. 개발자 탭에서 구성 수정을 클릭하여 구성 파일을 엽니다.
  3. gcloud auth print-access-token을 실행하여 API_KEY로 사용할 액세스 토큰을 생성합니다.

  1. 다음 구성을 추가하고 API_KEY를 생성한 토큰으로 바꾼 후 저장합니다.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Cline

  1. VS Code에서 Cline 확장 프로그램을 열고 MCP Servers 아이콘을 탭합니다.
  2. MCP 서버 구성을 탭하여 구성 파일을 엽니다.
  3. gcloud auth print-access-token을 실행하여 API_KEY로 사용할 액세스 토큰을 생성합니다.

  1. 다음 구성을 추가하고 API_KEY를 생성한 토큰으로 바꾼 후 저장합니다.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Cursor

  1. .cursor 디렉터리가 없으면 프로젝트 루트에 이 디렉터리를 만듭니다.
  2. .cursor/mcp.json 파일이 없으면 만들고 엽니다.
  3. gcloud auth print-access-token을 실행하여 API_KEY로 사용할 액세스 토큰을 생성합니다.
  1. 다음 구성을 추가하고 API_KEY를 생성된 토큰으로 바꾼 후 저장합니다.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Visual Studio Code(Copilot)

  1. VS Code를 열고 프로젝트 루트에 .vscode 디렉터리가 없으면 만듭니다.
  2. .vscode/mcp.json 파일이 없으면 만들고 엽니다.
  3. gcloud auth print-access-token을 실행하여 API_KEY로 사용할 액세스 토큰을 생성합니다.
  1. 다음 구성을 추가하고 API_KEY를 생성한 토큰으로 바꾼 후 저장합니다.

{
  "servers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Windsurf

  1. Windsurf를 열고 Cascade 어시스턴트로 이동합니다.
  2. MCP 아이콘을 클릭한 다음 구성을 클릭하여 구성 파일을 엽니다.
  3. gcloud auth print-access-token을 실행하여 API_KEY로 사용할 액세스 토큰을 생성합니다.

  1. 다음 구성을 추가하고 API_KEY를 생성한 토큰으로 바꾼 후 저장합니다.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Gemini CLI

  1. Gemini CLI를 설치합니다.
  2. 작업 디렉터리에 .gemini 폴더를 만듭니다. 이 폴더 내에 settings.json 파일을 만듭니다.
  3. gcloud auth print-access-token을 실행하여 API_KEY로 사용할 액세스 토큰을 생성합니다.

  1. 다음 구성을 추가하고 API_KEY를 생성한 토큰으로 바꾼 후 저장합니다.
{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

Gemini Code Assist

  1. Visual Studio Code에 Gemini Code Assist 확장 프로그램을 설치합니다.
  2. Gemini Code Assist 채팅에서 에이전트 모드를 사용 설정합니다.
  3. 작업 디렉터리에 .gemini 폴더를 만듭니다. 이 폴더 내에 settings.json 파일을 만듭니다.
  4. gcloud auth print-access-token을 실행하여 API_KEY로 사용할 액세스 토큰을 생성합니다.

  1. 다음 구성을 추가하고 API_KEY를 생성한 토큰으로 바꾼 후 저장합니다.

{
  "mcpServers": {
    "alloydb-admin": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt", "alloydb-postgres-admin", "--stdio"],
      "env": {
        "API_KEY": "API_KEY"
      }
    }
  }
}

이제 AI 도구가 MCP를 사용하여 PostgreSQL용 AlloyDB 컨트롤 플레인에 연결되었습니다. AI 어시스턴트에게 클러스터 또는 인스턴스를 생성하도록 요청하세요.

관리자 도구 사용

LLM에서 사용할 수 있는 도구는 다음과 같습니다.

  • alloydb-create-cluster: AlloyDB 클러스터를 만듭니다.
  • alloydb-create-instance: AlloyDB 인스턴스(PRIMARY, READ_POOL, SECONDARY)를 만듭니다.
  • alloydb-create-user: AlloyDB 클러스터의 ALLOYDB_BUILT_IN 또는 IAM 기반 사용자를 만듭니다.
  • alloydb-get-operation: 작업이 완료될 때까지 작업 API를 폴링합니다.
  • alloydb-list-clusters: 특정 프로젝트 및 위치의 클러스터를 나열합니다.
  • alloydb-list-instances: 특정 프로젝트 및 위치의 인스턴스를 나열합니다.
  • alloydb-list-users: 특정 프로젝트와 위치의 사용자를 나열합니다.

데이터에 연결

AlloyDB 클러스터와 인스턴스를 설정한 후 IDE를 데이터베이스에 연결하여 데이터를 쿼리할 수 있습니다. 자세한 내용은 MCP Toolbox를 사용해 IDE를 AlloyDB에 연결을 참조하세요.