docs/CLOUDSQLMYSQLADMIN_README.md
The Cloud SQL for MySQL Model Context Protocol (MCP) Server gives AI-powered development tools the ability to work with your Google Cloud SQL for MySQL databases. It supports connecting to instances, exploring schemas, and running queries.
An editor configured to use the Cloud SQL for MySQL MCP server can use its AI capabilities to help you:
To connect to the database to explore and query data, search the MCP store for the Cloud SQL for MySQL MCP Server.
roles/cloudsql.viewer)roles/cloudsql.admin)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@latestTo always run the latest version, update the MCP server configuration to use:npx -y @toolbox-sdk/server@latest --prebuilt cloud-sql-mysql-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.
Once configured, the MCP server will automatically provide Cloud SQL for MySQL capabilities to your AI assistant. You can:
The Cloud SQL for MySQL 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. |
Add the following configuration to your MCP client (e.g., settings.json for Gemini CLI, mcp_config.json for Antigravity):
{
"mcpServers": {
"cloud-sql-mysql-admin": {
"command": "npx",
"args": ["-y", "@toolbox-sdk/server", "--prebuilt", "cloud-sql-mysql-admin", "--stdio"]
}
}
}
For more information, visit the Cloud SQL for MySQL documentation.