Files
genai-toolbox/docs/CLOUDSQLMSSQLADMIN_README.md
2025-11-24 09:59:01 -08:00

3.8 KiB

Cloud SQL for SQL Server Admin MCP Server

The Cloud SQL for SQL Server Model Context Protocol (MCP) Server gives AI-powered development tools the ability to work with your Google Cloud SQL for SQL Server databases. It supports connecting to instances, exploring schemas, and running queries.

Features

An editor configured to use the Cloud SQL for SQL Server MCP server can use its AI capabilities to help you:

  • Provision & Manage Infrastructure - Create and manage Cloud SQL instances and users

Installation and Setup

Prerequisites

  • Download and install MCP Toolbox:

    1. Download the Toolbox binary: Download the latest binary for your operating system and architecture from the storage bucket. Check the releases page for OS and CPU architecture support: https://storage.googleapis.com/genai-toolbox/v0.21.0/<os>/<arch>/toolbox

      • Replace <os> with linux, darwin (macOS), or windows.
      • Replace <arch> with amd64 (Intel) or arm64 (Apple Silicon).
      curl -L -o toolbox https://storage.googleapis.com/genai-toolbox/v0.21.0/linux/amd64/toolbox
      
    2. Make it executable:

      chmod +x toolbox
      
    3. Move binary to /usr/local/bin/ or /usr/bin/:

      sudo mv toolbox /usr/local/bin/
      # sudo mv toolbox /usr/bin/
      

      On Windows, move binary to the WindowsApps\ folder:

      move "C:\Users\<path-to-binary>\toolbox.exe" "C:\Users\<username>\AppData\Local\Microsoft\WindowsApps\"
      

      Tip: Ensure the destination folder for your binary is included in your system's PATH environment variable. To check PATH, use echo $PATH (or echo %PATH% on Windows).

      Note: You may need to restart Antigravity for changes to take effect.

  • A Google Cloud project with the Cloud SQL Admin API enabled.

  • Ensure Application Default Credentials are available in your environment.

  • IAM Permissions:

  • Cloud SQL Viewer (roles/cloudsql.viewer)

  • Cloud SQL Admin (roles/cloudsql.admin)

Configuration

  1. Access the Store: Open the MCP Store panel within the "..." dropdown at the top of the editor's side panel.
  2. Browse and Install: Search for "Cloud SQL for SQL Server Admin", and click "Install".

Usage

Once configured, the MCP server will automatically provide Cloud SQL for SQL Server capabilities to your AI assistant. You can:

  • "Create a new Cloud SQL for SQL Server instance named 'e-commerce-prod' in the 'my-gcp-project' project."
  • "Create a new user named 'analyst' with read access to all tables."

Server Capabilities

The Cloud SQL for SQL Server MCP server provides the following tools:

Tool Name Description
create_instance Create an instance (PRIMARY, READ-POOL, or SECONDARY).
create_user Create BUILT-IN or IAM-based users for an instance.
get_instance Get details about an instance.
get_user Get details about a user in an instance.
list_instances List instances in a given project and location.
list_users List users in a given project and location.
wait_for_operation Poll the operations API until the operation is done.

Documentation

For more information, visit the Cloud SQL for SQL Server documentation.