Preview: This product is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.
The Database Migration Service managed MCP extension lets you manage migration jobs from your AI application. You can start, stop, resume, or delete migration jobs with Database Migration Service remote MCP server.
Google and Google Cloud managed MCP servers can be used in your AI applications with enterprise-ready governance, security, and access control.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
-
Get your administrator to grant you the MCP Tool User role (
roles/mcp.toolUser) on the Google Cloud project. If you created a new project, then you already have the required permissions. -
Ensure your administrator has enabled the Database Migration Service API on the Google Cloud project.
This extension uses Google Application Default Credentials (ADC) to perform authentication. To login with ADC, run the following command in your terminal:
gcloud auth application-default loginFor additional details, see the ADC documentation.
To install the extension, run the following command in your terminal:
gemini extensions install https://github.com/gemini-cli-extensions/database-migration-serviceTo see a complete list of available tools and their schemas, see the Database Migration Service MCP reference.
The following are example use cases for the Database Migration Service MCP server:
- List, get, start, and delete migration jobs in your project.
- List static IP addresses that Database Migration Service connects from to your source database during heterogeneous migrations.
- Use the get_operation tool to poll the status of operations such as starting or deleting a migration job.
- List all running migration jobs in project
PROJECT_IDand locationLOCATION. - List all migration jobs that encountered errors in project
PROJECT_IDand locationLOCATION. - What's the status of the migration job
MIGRATION_JOB_IDinLOCATION? - Stop the migration job
MIGRATION_JOB_IDinLOCATION. - Resume all stopped migration jobs
MIGRATION_JOB_IDinLOCATION.
In the prompts, replace the following:
PROJECT_IDwith your Google Cloud project identifier.LOCATIONwith the location of the migration job.MIGRATION_JOB_IDwith your Database Migration Service migration job identifier.
MCP introduces new security risks and considerations due to the wide variety of actions that you can take with MCP tools. To minimize and manage these risks, Google Cloud offers defaults and customizable policies to control the use of MCP tools in your Google Cloud organization or project.
For more information about MCP security and governance, see AI security and safety.
The Database Migration Service MCP server doesn't have its own quotas. There is no limit on the number of call that can be made to the MCP server. You are still subject to the quotas enforced by the APIs called by the MCP server tools.
- Explore the Database Migration Service remote MCP server reference documentation, which includes a list of all available tools, and the full input and output schema for each tool.
- See the Database Migration Service overview.
- Learn about MCP security and governance.