@google-cloud/cloud-run-mcp 1.3.0 → 1.5.0

package/.github/workflows/local-tests.yml

@@ -3,7 +3,7 @@ name: Run Local Tests
 on:
   push:
   pull_request:
-    branches: [ main ]
+    branches: [main]
 
 jobs:
   test:

package/CONTRIBUTING.md

@@ -25,6 +25,12 @@ This project follows
 
 ## Contribution process
 
+### Start with an issue
+
+Before sending a pull request, please open an issue describing the bug or feature
+you would like to address. This will allow maintainers of this project to guide
+you in your design and implementation.
+
 ### Code reviews
 
 All submissions, including submissions by project members, require review. We

package/README.md

@@ -11,13 +11,17 @@ Enable MCP-compatible AI agents to deploy apps to Cloud Run.
 }
 ```
 
+Deploy from Gemini CLI and other AI-powered CLI agents:  
+
+<img  src="https://raw.githubusercontent.com/GoogleCloudPlatform/cloud-run-mcp/refs/heads/main/.github/images/deploycli.gif" width="800">
+
 Deploy from AI-powered IDEs:
 
-<img src="https://github.com/user-attachments/assets/9fdcec30-2b38-4362-9eb1-54cab09e99d4" width="800">
+<img src="https://raw.githubusercontent.com/GoogleCloudPlatform/cloud-run-mcp/refs/heads/main/.github/images/deploy_from_ide.gif" width="800">
 
 Deploy from AI assistant apps:
 
-<img src="https://github.com/user-attachments/assets/b10f0335-b332-4640-af38-ea015b46b57c" width="800">
+<img src="https://raw.githubusercontent.com/GoogleCloudPlatform/cloud-run-mcp/refs/heads/main/.github/images/deploy_from_apps.gif" width="800">
 
 Deploy from agent SDKs, like the [Google Gen AI SDK](https://ai.google.dev/gemini-api/docs/function-calling?example=meeting#use_model_context_protocol_mcp) or [Agent Development Kit](https://google.github.io/adk-docs/tools/mcp-tools/).
 
@@ -30,7 +34,7 @@ Deploy from agent SDKs, like the [Google Gen AI SDK](https://ai.google.dev/gemin
 - `list-services`: Lists Cloud Run services in a given project and region.
 - `get-service`: Gets details for a specific Cloud Run service.
 - `get-service-log`: Gets Logs and Error Messages for a specific Cloud Run service.
-- `deploy-local-files`\*: Deploys files from the local file system to a Google Cloud Run service.
+
 - `deploy-local-folder`\*: Deploys a local folder to a Google Cloud Run service.
 - `list-projects`\*: Lists available GCP projects.
 - `create-project`\*: Creates a new GCP project and attach it to the first available billing account. A project ID can be optionally specified.
@@ -44,6 +48,18 @@ Prompts are natural language commands that can be used to perform common tasks.
 - `deploy`: Deploys the current working directory to Cloud Run. If a service name is not provided, it will use the `DEFAULT_SERVICE_NAME` environment variable, or the name of the current working directory.
 - `logs`: Gets the logs for a Cloud Run service. If a service name is not provided, it will use the `DEFAULT_SERVICE_NAME` environment variable, or the name of the current working directory.
 
+
+## Use as a Gemini CLI extension
+
+To install this as a [Gemini CLI](https://github.com/google-gemini/gemini-cli) extension, run the following command:
+
+```bash
+mkdir -p ~/.gemini/extensions/cloud-run/gemini-extension && \
+  curl -s -L https://raw.githubusercontent.com/GoogleCloudPlatform/cloud-run-mcp/main/gemini-extension.json > ~/.gemini/extensions/cloud-run/gemini-extension.json && \
+  curl -s -L https://raw.githubusercontent.com/GoogleCloudPlatform/cloud-run-mcp/main/gemini-extension/GEMINI.md > ~/.gemini/extensions/cloud-run/gemini-extension/GEMINI.md
+```
+
+
 ## Use as local MCP server
 
 Run the Cloud Run MCP server on your local machine using local Google Cloud credentials. This is best if you are using an AI-assisted IDE (e.g. Cursor) or a desktop AI application (e.g. Claude).
@@ -118,19 +134,8 @@ See Docker's [MCP catalog](https://hub.docker.com/mcp/server/cloud-run-mcp/overv
       }
    ```
 
-## Use as a Gemini CLI extension
-
-To install this as a [Gemini CLI](https://github.com/google-gemini/gemini-cli) extension, run the following command:
-
-```bash
-mkdir -p ~/.gemini/extensions/cloud-run/gemini-extension && \
-  curl -s -L https://raw.githubusercontent.com/GoogleCloudPlatform/cloud-run-mcp/main/gemini-extension.json > ~/.gemini/extensions/cloud-run/gemini-extension.json && \
-  curl -s -L https://raw.githubusercontent.com/GoogleCloudPlatform/cloud-run-mcp/main/gemini-extension/Gemini.md > ~/.gemini/extensions/cloud-run/gemini-extension/Gemini.md
-```
-
 ## Use as remote MCP server
 
-
 > [!WARNING]  
 > Do not use the remote MCP server without authentication. In the following instructions, we will use IAM authentication to secure the connection to the MCP server from your local machine. This is important to prevent unauthorized access to your Google Cloud resources.
 

package/gemini-extension/GEMINI.md

@@ -47,11 +47,11 @@ server {
 The user must have an existing Google Cloud account with billing set up, and ideally an existing Google Cloud project.
 
 If deployment fails because of an access or IAM error, it is likely that the user doesn't have Google Cloud credentials on the local machine.
-The user mush follow these steps:
+The user must follow these steps:
 
 1. Install the [Google Cloud SDK](https://cloud.google.com/sdk/docs/install) and authenticate with their Google account.
 
 2. Set up application credentials using the command:
    ```bash
    gcloud auth application-default login
-   ```
+   ```

package/lib/cloud-run-deploy.js

@@ -48,7 +48,7 @@ let runClient;
  * @param {function(object): void} [progressCallback] - Optional callback for progress updates.
  * @param {'debug' | 'info' | 'warn' | 'error'} [severity='info'] - The severity level of the message.
  */
-function logAndProgress(message, progressCallback, severity = 'info') {
+async function logAndProgress(message, progressCallback, severity = 'info') {
   switch (severity) {
     case 'error':
       console.error(message);
@@ -89,14 +89,14 @@ async function checkCloudRunServiceExists(
       () => runClient.getService({ name: servicePath }),
       `getService ${serviceId}`
     );
-    logAndProgress(
+    await logAndProgress(
       `Cloud Run service ${serviceId} already exists.`,
       progressCallback
     );
     return true;
   } catch (error) {
     if (error.code === 5) {
-      logAndProgress(
+      await logAndProgress(
         `Cloud Run service ${serviceId} does not exist.`,
         progressCallback
       );
@@ -104,7 +104,7 @@ async function checkCloudRunServiceExists(
     }
     const errorMessage = `Error checking Cloud Run service ${serviceId}: ${error.message}`;
     console.error(`Error checking Cloud Run service ${serviceId}:`, error);
-    logAndProgress(errorMessage, progressCallback, 'error');
+    await logAndProgress(errorMessage, progressCallback, 'error');
     throw error;
   }
 }
@@ -160,7 +160,7 @@ async function deployToCloudRun(
 
     // Always perform a dry run first for general validation
     try {
-      logAndProgress(
+      await logAndProgress(
         `Performing dry run for service ${serviceId}...`,
         progressCallback,
         'debug'
@@ -189,13 +189,13 @@ async function deployToCloudRun(
           `createService (dry run) ${serviceId}`
         );
       }
-      logAndProgress(
+      await logAndProgress(
         `Dry run successful for ${serviceId} with current configuration.`,
         progressCallback,
         'debug'
       );
     } catch (dryRunError) {
-      logAndProgress(
+      await logAndProgress(
         `Dry run for ${serviceId} failed: ${dryRunError.message}`,
         progressCallback,
         'warn'
@@ -209,7 +209,7 @@ async function deployToCloudRun(
           dryRunError.message.toLowerCase().includes('iam policy violation') ||
           dryRunError.code === 3) /* INVALID_ARGUMENT */
       ) {
-        logAndProgress(
+        await logAndProgress(
           `Dry run suggests 'invokerIamDisabled' is not allowed or invalid. Attempting deployment without it.`,
           progressCallback,
           'warn'
@@ -218,14 +218,14 @@ async function deployToCloudRun(
       } else {
         // For any other validation errors, rethrow to stop the deployment
         const errorMessage = `Dry run validation failed for service ${serviceId}: ${dryRunError.message}`;
-        logAndProgress(errorMessage, progressCallback, 'error');
+        await logAndProgress(errorMessage, progressCallback, 'error');
         throw new Error(errorMessage);
       }
     }
 
     let operation;
     if (exists) {
-      logAndProgress(
+      await logAndProgress(
         `Updating existing service ${serviceId}...`,
         progressCallback
       );
@@ -235,7 +235,7 @@ async function deployToCloudRun(
         `updateService ${serviceId}`
       );
     } else {
-      logAndProgress(`Creating new service ${serviceId}...`, progressCallback);
+      await logAndProgress(`Creating new service ${serviceId}...`, progressCallback);
       [operation] = await callWithRetry(
         () =>
           runClient.createService({
@@ -247,10 +247,13 @@ async function deployToCloudRun(
       );
     }
 
-    logAndProgress(`Deploying ${serviceId} to Cloud Run...`, progressCallback);
+    await logAndProgress(
+      `Deploying ${serviceId} to Cloud Run...`,
+      progressCallback
+    );
     const [response] = await operation.promise();
 
-    logAndProgress(
+    await logAndProgress(
       `Service deployed/updated successfully: ${response.uri}`,
       progressCallback
     );
@@ -258,7 +261,7 @@ async function deployToCloudRun(
   } catch (error) {
     const errorMessage = `Error deploying/updating service ${serviceId}: ${error.message}`;
     console.error(`Error deploying/updating service ${serviceId}:`, error);
-    logAndProgress(errorMessage, progressCallback, 'error');
+    await logAndProgress(errorMessage, progressCallback, 'error');
     throw error;
   }
 }
@@ -286,10 +289,13 @@ async function ensureStorageBucketExists(
       `storage.bucket.exists ${bucketName}`
     );
     if (exists) {
-      logAndProgress(`Bucket ${bucketName} already exists.`, progressCallback);
+      await logAndProgress(
+        `Bucket ${bucketName} already exists.`,
+        progressCallback
+      );
       return bucket;
     } else {
-      logAndProgress(
+      await logAndProgress(
         `Bucket ${bucketName} does not exist. Creating in location ${location}...`,
         progressCallback
       );
@@ -298,7 +304,7 @@ async function ensureStorageBucketExists(
           () => storage.createBucket(bucketName, { location: location }),
           `storage.createBucket ${bucketName}`
         );
-        logAndProgress(
+        await logAndProgress(
           `Storage bucket ${createdBucket.name} created successfully in ${location}.`,
           progressCallback
         );
@@ -309,14 +315,14 @@ async function ensureStorageBucketExists(
           `Failed to create storage bucket ${bucketName}. Error details:`,
           createError
         );
-        logAndProgress(errorMessage, progressCallback, 'error');
+        await logAndProgress(errorMessage, progressCallback, 'error');
         throw createError;
       }
     }
   } catch (error) {
     const errorMessage = `Error checking/creating bucket ${bucketName}: ${error.message}`;
     console.error(`Error checking/creating bucket ${bucketName}:`, error);
-    logAndProgress(errorMessage, progressCallback, 'error');
+    await logAndProgress(errorMessage, progressCallback, 'error');
     throw error;
   }
 }
@@ -417,7 +423,7 @@ async function uploadToStorageBucket(
   progressCallback
 ) {
   try {
-    logAndProgress(
+    await logAndProgress(
       `Uploading buffer to gs://${bucket.name}/${destinationBlobName}...`,
       progressCallback
     );
@@ -425,7 +431,7 @@ async function uploadToStorageBucket(
       () => bucket.file(destinationBlobName).save(buffer),
       `storage.bucket.file.save ${destinationBlobName}`
     );
-    logAndProgress(
+    await logAndProgress(
       `File ${destinationBlobName} uploaded successfully to gs://${bucket.name}/${destinationBlobName}.`,
       progressCallback
     );
@@ -433,7 +439,7 @@ async function uploadToStorageBucket(
   } catch (error) {
     const errorMessage = `Error uploading buffer: ${error.message}`;
     console.error(`Error uploading buffer:`, error);
-    logAndProgress(errorMessage, progressCallback, 'error');
+    await logAndProgress(errorMessage, progressCallback, 'error');
     throw error;
   }
 }
@@ -470,14 +476,14 @@ async function ensureArtifactRegistryRepoExists(
       () => artifactRegistryClient.getRepository({ name: repoPath }),
       `artifactRegistry.getRepository ${repositoryId}`
     );
-    logAndProgress(
+    await logAndProgress(
       `Repository ${repositoryId} already exists in ${location}.`,
       progressCallback
     );
     return repository;
   } catch (error) {
     if (error.code === 5) {
-      logAndProgress(
+      await logAndProgress(
         `Repository ${repositoryId} does not exist in ${location}. Creating...`,
         progressCallback
       );
@@ -494,12 +500,12 @@ async function ensureArtifactRegistryRepoExists(
           }),
         `artifactRegistry.createRepository ${repositoryId}`
       );
-      logAndProgress(
+      await logAndProgress(
         `Creating Artifact Registry repository ${repositoryId}...`,
         progressCallback
       );
       const [result] = await operation.promise();
-      logAndProgress(
+      await logAndProgress(
         `Artifact Registry repository ${result.name} created successfully.`,
         progressCallback
       );
@@ -510,7 +516,7 @@ async function ensureArtifactRegistryRepoExists(
         `Error checking/creating repository ${repositoryId}:`,
         error
       );
-      logAndProgress(errorMessage, progressCallback, 'error');
+      await logAndProgress(errorMessage, progressCallback, 'error');
       throw error;
     }
   }
@@ -580,7 +586,7 @@ async function triggerCloudBuild(
     images: [targetImageUrl],
   };
 
-  logAndProgress(
+  await logAndProgress(
     `Initiating Cloud Build for gs://${sourceBucketName}/${sourceBlobName} in ${location}...`,
     progressCallback
   );
@@ -589,7 +595,7 @@ async function triggerCloudBuild(
     'cloudBuild.createBuild'
   );
 
-  logAndProgress(`Cloud Build job started...`, progressCallback);
+  await logAndProgress(`Cloud Build job started...`, progressCallback);
   const buildId = operation.metadata.build.id;
   let completedBuild;
   while (true) {
@@ -605,7 +611,7 @@ async function triggerCloudBuild(
       completedBuild = getBuildOperation;
       break;
     }
-    logAndProgress(
+    await logAndProgress(
       `Build status: ${getBuildOperation.status}. Waiting...`,
       progressCallback,
       'debug'
@@ -614,20 +620,20 @@ async function triggerCloudBuild(
   }
 
   if (completedBuild.status === 'SUCCESS') {
-    logAndProgress(
+    await logAndProgress(
       `Cloud Build job ${buildId} completed successfully.`,
       progressCallback
     );
-    logAndProgress(
+    await logAndProgress(
       `Image built: ${completedBuild.results.images[0].name}`,
       progressCallback
     );
     return completedBuild;
   } else {
     const failureMessage = `Cloud Build job ${buildId} failed with status: ${completedBuild.status}`;
-    logAndProgress(failureMessage, progressCallback, 'error');
+    await logAndProgress(failureMessage, progressCallback, 'error');
     const logsMessage = `Build logs: ${completedBuild.logUrl}`;
-    logAndProgress(logsMessage, progressCallback); // Log URL is info, failure is error
+    await logAndProgress(logsMessage, progressCallback); // Log URL is info, failure is error
 
     let buildLogsSnippet = `\n\nRefer to Log URL for full details: ${completedBuild.logUrl}`; // Default snippet
     try {
@@ -635,7 +641,7 @@ async function triggerCloudBuild(
       const loggingClient = new Logging({ projectId });
 
       const logFilter = `resource.type="build" AND resource.labels.build_id="${buildId}"`;
-      logAndProgress(
+      await logAndProgress(
         `Attempting to fetch last ${BUILD_LOGS_LINES_TO_FETCH} log lines for build ${buildId}...`,
         progressCallback,
         'debug'
@@ -662,14 +668,14 @@ async function triggerCloudBuild(
         const logLines = entries.reverse().map((entry) => entry.data || '');
         if (logLines.length > 0) {
           buildLogsSnippet = `\n\nLast ${logLines.length} log lines from build ${buildId}:\n${logLines.join('\n')}`;
-          logAndProgress(
+          await logAndProgress(
             `Successfully fetched snippet of build logs for ${buildId}.`,
             progressCallback,
             'info'
           );
         }
       } else {
-        logAndProgress(
+        await logAndProgress(
           `No specific log entries retrieved for build ${buildId}. ${buildLogsSnippet}`,
           progressCallback,
           'warn'
@@ -677,7 +683,7 @@ async function triggerCloudBuild(
       }
     } catch (logError) {
       console.error(`Error fetching build logs for ${buildId}:`, logError);
-      logAndProgress(
+      await logAndProgress(
         `Failed to fetch build logs snippet: ${logError.message}. ${buildLogsSnippet}`,
         progressCallback,
         'warn'
@@ -710,14 +716,21 @@ export async function deploy({
   if (!projectId) {
     const errorMsg =
       'Error: projectId is required in the configuration object.';
-    logAndProgress(errorMsg, progressCallback, 'error');
-    process.exit(1);
+    await logAndProgress(errorMsg, progressCallback, 'error');
+    throw new Error(errorMsg);
+  }
+
+  if (!serviceName) {
+    const errorMsg =
+      'Error: serviceName is required in the configuration object.';
+    await logAndProgress(errorMsg, progressCallback, 'error');
+    throw new Error(errorMsg);
   }
 
   if (!files || !Array.isArray(files) || files.length === 0) {
     const errorMsg =
       'Error: files array is required in the configuration object.';
-    logAndProgress(errorMsg, progressCallback, 'error');
+    await logAndProgress(errorMsg, progressCallback, 'error');
     if (typeof process !== 'undefined' && process.exit) {
       process.exit(1);
     } else {
@@ -750,10 +763,10 @@ export async function deploy({
     const bucketName = `${projectId}-source-bucket`;
     const imageUrl = `${region}-docker.pkg.dev/${projectId}/${REPO_NAME}/${serviceName}:${IMAGE_TAG}`;
 
-    logAndProgress(`Project: ${projectId}`, progressCallback);
-    logAndProgress(`Region: ${region}`, progressCallback);
-    logAndProgress(`Service Name: ${serviceName}`, progressCallback);
-    logAndProgress(`Files to deploy: ${files.length}`, progressCallback);
+    await logAndProgress(`Project: ${projectId}`, progressCallback);
+    await logAndProgress(`Region: ${region}`, progressCallback);
+    await logAndProgress(`Service Name: ${serviceName}`, progressCallback);
+    await logAndProgress(`Files to deploy: ${files.length}`, progressCallback);
 
     let hasDockerfile = false;
     if (
@@ -786,7 +799,7 @@ export async function deploy({
         }
       }
     }
-    logAndProgress(`Dockerfile: ${hasDockerfile}`, progressCallback);
+    await logAndProgress(`Dockerfile: ${hasDockerfile}`, progressCallback);
 
     const bucket = await ensureStorageBucketExists(
       bucketName,
@@ -801,7 +814,7 @@ export async function deploy({
       ZIP_FILE_NAME,
       progressCallback
     );
-    logAndProgress('Source code uploaded successfully', progressCallback);
+    await logAndProgress('Source code uploaded successfully', progressCallback);
 
     await ensureArtifactRegistryRepoExists(
       projectId,
@@ -833,12 +846,12 @@ export async function deploy({
       skipIamCheck
     );
 
-    logAndProgress(`Deployment Completed Successfully`, progressCallback);
+    await logAndProgress(`Deployment Completed Successfully`, progressCallback);
     return service;
   } catch (error) {
     const deployFailedMessage = `Deployment Failed: ${error.message}`;
     console.error(`Deployment Failed`, error);
-    logAndProgress(deployFailedMessage, progressCallback, 'error');
+    await logAndProgress(deployFailedMessage, progressCallback, 'error');
     throw error;
   }
 }
@@ -866,13 +879,20 @@ export async function deployImage({
   if (!projectId) {
     const errorMsg =
       'Error: projectId is required in the configuration object.';
-    logAndProgress(errorMsg, progressCallback, 'error');
-    process.exit(1);
+    await logAndProgress(errorMsg, progressCallback, 'error');
+    throw new Error(errorMsg);
+  }
+
+  if (!serviceName) {
+    const errorMsg =
+      'Error: serviceName is required in the configuration object.';
+    await logAndProgress(errorMsg, progressCallback, 'error');
+    throw new Error(errorMsg);
   }
 
   if (!imageUrl) {
     const errorMsg = 'Error: imageUrl is required in the configuration object.';
-    logAndProgress(errorMsg, progressCallback, 'error');
+    await logAndProgress(errorMsg, progressCallback, 'error');
     if (typeof process !== 'undefined' && process.exit) {
       process.exit(1);
     } else {
@@ -892,10 +912,10 @@ export async function deployImage({
 
     runClient = new ServicesClient({ projectId });
 
-    logAndProgress(`Project: ${projectId}`, progressCallback);
-    logAndProgress(`Region: ${region}`, progressCallback);
-    logAndProgress(`Service Name: ${serviceName}`, progressCallback);
-    logAndProgress(`Image URL: ${imageUrl}`, progressCallback);
+    await logAndProgress(`Project: ${projectId}`, progressCallback);
+    await logAndProgress(`Region: ${region}`, progressCallback);
+    await logAndProgress(`Service Name: ${serviceName}`, progressCallback);
+    await logAndProgress(`Image URL: ${imageUrl}`, progressCallback);
 
     const service = await deployToCloudRun(
       projectId,
@@ -906,12 +926,12 @@ export async function deployImage({
       skipIamCheck
     );
 
-    logAndProgress(`Deployment Completed Successfully`, progressCallback);
+    await logAndProgress(`Deployment Completed Successfully`, progressCallback);
     return service;
   } catch (error) {
     const deployFailedMessage = `Deployment Failed: ${error.message}`;
     console.error(`Deployment Failed`, error);
-    logAndProgress(deployFailedMessage, progressCallback, 'error');
+    await logAndProgress(deployFailedMessage, progressCallback, 'error');
     throw error;
   }
 }

package/mcp-server.js

@@ -23,7 +23,8 @@ import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/
 import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
 // Support stdio, as it is easier to use locally
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { registerTools, registerToolsRemote } from './tools.js';
+import { registerTools, registerToolsRemote } from './tools/tools.js';
+import { SetLevelRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { registerPrompts } from './prompts.js';
 import { checkGCP } from './lib/gcp-metadata.js';
 import { ensureGCPCredentials } from './lib/gcp-auth-check.js';
@@ -71,6 +72,12 @@ async function getServer() {
     { capabilities: { logging: {} } }
   );
 
+  // this is no-op handler is required for mcp-inspector to function due to a mismatch between the SDK mcp-inspector
+  server.server.setRequestHandler(SetLevelRequestSchema, (request) => {
+    console.log(`Log Level: ${request.params.level}`);
+    return {};
+  });
+
   // Get GCP metadata info once
   const gcpInfo = await checkGCP();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google-cloud/cloud-run-mcp",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "type": "module",
   "description": "Cloud Run MCP deployment tool",
   "main": "mcp-server.js",
@@ -10,8 +10,8 @@
   "scripts": {
     "deploy": "gcloud run deploy cloud-run-mcp --source . --no-invoker-iam-check",
     "test:deploy": "node test/need-gcp/cloud-run-deploy.test.js",
-    "test:create-project": "node test/need-gcp/gcp-projects.test.js",
-    "test:service-logs": "node test/need-gcp/cloud-run-services.test.js",
+    "test:projects": "node test/need-gcp/gcp-projects.test.js",
+    "test:services": "node test/need-gcp/cloud-run-services.test.js",
     "test:gcp-auth": "node test/need-gcp/gcp-auth-check.test.js",
     "test:prompts": "node --test test/local/prompts.test.js",
     "test:mcp": "node --test test/local/mcp-server.test.js",

package/test/local/mcp-server.test.js

@@ -35,7 +35,6 @@ describe('MCP Server in stdio mode', () => {
         'create_project',
         'deploy_container_image',
         'deploy_file_contents',
-        'deploy_local_files',
         'deploy_local_folder',
         'get_service',
         'get_service_log',

package/test/local/notifications.test.js

@@ -0,0 +1,45 @@
+import assert from 'node:assert/strict';
+import { describe, it, mock } from 'node:test';
+import esmock from 'esmock';
+
+describe('Tool Notifications', () => {
+  it('should send notifications during deployment', async () => {
+    const server = {
+      registerTool: mock.fn(),
+    };
+
+  const { registerTools } = await esmock('../../tools/tools.js', {}, {
+      '../../lib/cloud-run-deploy.js': {
+        deploy: () => Promise.resolve({ uri: 'my-uri' }),
+      },
+    },
+  );
+
+    registerTools(server, { gcpCredentialsAvailable: true });
+
+    const handler = server.registerTool.mock.calls.find(
+      (call) => call.arguments[0] === 'deploy_local_folder'
+    ).arguments[2];
+
+    const sendNotification = mock.fn();
+
+    await handler(
+      {
+        project: 'my-project',
+        region: 'my-region',
+        service: 'my-service',
+        folderPath: '/my/folder',
+      },
+      { sendNotification }
+    );
+
+    assert.strictEqual(sendNotification.mock.callCount(), 1);
+    assert.deepStrictEqual(sendNotification.mock.calls[0].arguments[0], {
+      method: 'notifications/message',
+      params: {
+        level: 'info',
+        data: 'Starting deployment of local folder for service my-service in project my-project...',
+      },
+    });
+  });
+});