Files
genai-toolbox/docs/CLOUDSQLMSSQLADMIN_README.md
Twisha Bansal e0245946ea docs: standardize installation note for antigravity plugins (#2373)
## Description

> Should include a concise description of the changes (bug or feature),
it's
> impact, along with a summary of the solution

## PR Checklist

> Thank you for opening a Pull Request! Before submitting your PR, there
are a
> few things you can do to make sure it goes smoothly:

- [x] Make sure you reviewed

[CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md)
- [ ] Make sure to open an issue as a

[bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose)
  before writing your code! That way we can discuss the change, evaluate
  designs, and agree on the general idea
- [ ] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [ ] Appropriate docs were updated (if necessary)
- [ ] Make sure to add `!` if this involve a breaking change

🛠️ Fixes #<issue_number_goes_here>
2026-01-30 10:25:29 +05:30

3.5 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

To connect to the database to explore and query data, search the MCP store for the Cloud SQL for SQL Server MCP Server.

Prerequisites

  • Node.js installed.
  • 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)

Install & Configuration

In the Antigravity MCP Store, click the "Install" button.

Note

On first use, the installation process automatically downloads and uses MCP Toolbox >=0.26.0. To update MCP Toolbox, use: npm i -g @toolbox-sdk/server@latest To always run the latest version, update the MCP server configuration to use: npx -y @toolbox-sdk/server@latest --prebuilt cloud-sql-mssql-admin.

You'll now be able to see all enabled tools in the "Tools" tab.

Note

If you encounter issues with Windows Defender blocking the execution, you may need to configure an allowlist. See Configure exclusions for Microsoft Defender Antivirus for more details.

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.

Custom MCP Server Configuration

Add the following configuration to your MCP client (e.g., settings.json for Gemini CLI, mcp_config.json for Antigravity):

{
  "mcpServers": {
    "cloud-sql-sqlserver-admin": {
      "command": "npx",
      "args": ["-y", "@toolbox-sdk/server", "--prebuilt", "cloud-sql-mssql-admin", "--stdio"]
    }
  }
}

Documentation

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