@google-cloud/storage-mcp 0.3.3 → 0.4.0

package/README.md

@@ -149,7 +149,7 @@ ones. They will never modify or delete existing data in GCS.
 | `list_objects`              | Lists objects in a GCS bucket.                                                                                              |
 | `read_object_metadata`      | Reads comprehensive metadata for a specific object.                                                                         |
 | `read_object_content`       | Reads the content of a specific object.                                                                                     |
-| `download_object`           | Downloads an object from GCS to a local file.                                                                               |
+| `download_object_safe`      | Downloads an object from GCS to a local file. Fails if the destination file already exists.                                 |
 | `write_object_new`          | Writes a new object. Fails if the object already exists.                                                                    |
 | `upload_object_new`         | Uploads a file to a new object. Fails if the object already exists.                                                         |
 | `copy_object_new`           | Copies an object to a new destination. Fails if the destination already exists.                                             |
@@ -173,6 +173,7 @@ counterparts (e.g., `write_object` is registered instead of `write_object_new`).
 | `update_bucket_labels`   | **Modifies** labels for a bucket.                          |
 | `delete_object`          | **Deletes** a specific object from a bucket.               |
 | `update_object_metadata` | **Modifies** the custom metadata of an existing object.    |
+| `download_object`        | Downloads an object, **overwriting** the destination file. |
 | `move_object`            | **Moves** an object (copies then deletes the original).    |
 | `write_object`           | Writes an object, **overwriting** it if it already exists. |
 | `upload_object`          | Uploads a file, **overwriting** the destination object.    |

package/dist/bundle.js

@@ -4725,6 +4725,7 @@ var require_pattern = __commonJS({
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     var code_1 = require_code2();
+    var util_1 = require_util();
     var codegen_1 = require_codegen();
     var error2 = {
       message: ({ schemaCode }) => (0, codegen_1.str)`must match pattern "${schemaCode}"`,
@@ -4737,10 +4738,18 @@ var require_pattern = __commonJS({
       $data: true,
       error: error2,
       code(cxt) {
-        const { data, $data, schema, schemaCode, it } = cxt;
+        const { gen, data, $data, schema, schemaCode, it } = cxt;
         const u = it.opts.unicodeRegExp ? "u" : "";
-        const regExp = $data ? (0, codegen_1._)`(new RegExp(${schemaCode}, ${u}))` : (0, code_1.usePattern)(cxt, schema);
-        cxt.fail$data((0, codegen_1._)`!${regExp}.test(${data})`);
+        if ($data) {
+          const { regExp } = it.opts.code;
+          const regExpCode = regExp.code === "new RegExp" ? (0, codegen_1._)`new RegExp` : (0, util_1.useFunc)(gen, regExp);
+          const valid = gen.let("valid");
+          gen.try(() => gen.assign(valid, (0, codegen_1._)`${regExpCode}(${schemaCode}, ${u}).test(${data})`), () => gen.assign(valid, false));
+          cxt.fail$data((0, codegen_1._)`!${valid}`);
+        } else {
+          const regExp = (0, code_1.usePattern)(cxt, schema);
+          cxt.fail$data((0, codegen_1._)`!${regExp}.test(${data})`);
+        }
       }
     };
     exports.default = def;
@@ -10614,6 +10623,7 @@ var require_pattern2 = __commonJS({
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     var code_1 = require_code4();
+    var util_1 = require_util2();
     var codegen_1 = require_codegen2();
     var error2 = {
       message: ({ schemaCode }) => (0, codegen_1.str)`must match pattern "${schemaCode}"`,
@@ -10626,10 +10636,18 @@ var require_pattern2 = __commonJS({
       $data: true,
       error: error2,
       code(cxt) {
-        const { data, $data, schema, schemaCode, it } = cxt;
+        const { gen, data, $data, schema, schemaCode, it } = cxt;
         const u = it.opts.unicodeRegExp ? "u" : "";
-        const regExp = $data ? (0, codegen_1._)`(new RegExp(${schemaCode}, ${u}))` : (0, code_1.usePattern)(cxt, schema);
-        cxt.fail$data((0, codegen_1._)`!${regExp}.test(${data})`);
+        if ($data) {
+          const { regExp } = it.opts.code;
+          const regExpCode = regExp.code === "new RegExp" ? (0, codegen_1._)`new RegExp` : (0, util_1.useFunc)(gen, regExp);
+          const valid = gen.let("valid");
+          gen.try(() => gen.assign(valid, (0, codegen_1._)`${regExpCode}(${schemaCode}, ${u}).test(${data})`), () => gen.assign(valid, false));
+          cxt.fail$data((0, codegen_1._)`!${valid}`);
+        } else {
+          const regExp = (0, code_1.usePattern)(cxt, schema);
+          cxt.fail$data((0, codegen_1._)`!${regExp}.test(${data})`);
+        }
       }
     };
     exports.default = def;
@@ -12462,12 +12480,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs3, exportName) {
+    function addFormats(ajv, list, fs4, exportName) {
       var _a2;
       var _b2;
       (_a2 = (_b2 = ajv.opts.code).formats) !== null && _a2 !== void 0 ? _a2 : _b2.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list)
-        ajv.addFormat(f, fs3[f]);
+        ajv.addFormat(f, fs4[f]);
     }
     module.exports = exports = formatsPlugin;
     Object.defineProperty(exports, "__esModule", { value: true });
@@ -26316,12 +26334,12 @@ var McpServer = class {
     }
     return registeredPrompt;
   }
-  _createRegisteredTool(name, title, description, inputSchema25, outputSchema, annotations, execution, _meta, handler) {
+  _createRegisteredTool(name, title, description, inputSchema26, outputSchema, annotations, execution, _meta, handler) {
     validateAndWarnToolName(name);
     const registeredTool = {
       title,
       description,
-      inputSchema: getZodSchemaObject(inputSchema25),
+      inputSchema: getZodSchemaObject(inputSchema26),
       outputSchema: getZodSchemaObject(outputSchema),
       annotations,
       execution,
@@ -26372,7 +26390,7 @@ var McpServer = class {
       throw new Error(`Tool ${name} is already registered`);
     }
     let description;
-    let inputSchema25;
+    let inputSchema26;
     let outputSchema;
     let annotations;
     if (typeof rest[0] === "string") {
@@ -26381,7 +26399,7 @@ var McpServer = class {
     if (rest.length > 1) {
       const firstArg = rest[0];
       if (isZodRawShapeCompat(firstArg)) {
-        inputSchema25 = rest.shift();
+        inputSchema26 = rest.shift();
         if (rest.length > 1 && typeof rest[0] === "object" && rest[0] !== null && !isZodRawShapeCompat(rest[0])) {
           annotations = rest.shift();
         }
@@ -26390,7 +26408,7 @@ var McpServer = class {
       }
     }
     const callback = rest[0];
-    return this._createRegisteredTool(name, void 0, description, inputSchema25, outputSchema, annotations, { taskSupport: "forbidden" }, void 0, callback);
+    return this._createRegisteredTool(name, void 0, description, inputSchema26, outputSchema, annotations, { taskSupport: "forbidden" }, void 0, callback);
   }
   /**
    * Registers a tool with a config object and callback.
@@ -26399,8 +26417,8 @@ var McpServer = class {
     if (this._registeredTools[name]) {
       throw new Error(`Tool ${name} is already registered`);
     }
-    const { title, description, inputSchema: inputSchema25, outputSchema, annotations, _meta } = config2;
-    return this._createRegisteredTool(name, title, description, inputSchema25, outputSchema, annotations, { taskSupport: "forbidden" }, _meta, cb);
+    const { title, description, inputSchema: inputSchema26, outputSchema, annotations, _meta } = config2;
+    return this._createRegisteredTool(name, title, description, inputSchema26, outputSchema, annotations, { taskSupport: "forbidden" }, _meta, cb);
   }
   prompt(name, ...rest) {
     if (this._registeredPrompts[name]) {
@@ -27427,8 +27445,71 @@ var registerDownloadObjectTool = (server) => {
   );
 };
 
-// src/tools/objects/list_objects.ts
+// src/tools/objects/download_object_safe.ts
+import fs from "fs";
 var inputSchema13 = {
+  bucket_name: external_exports.string().describe("The name of the GCS bucket."),
+  object_name: external_exports.string().describe("The name of the object to download."),
+  file_path: external_exports.string().describe("The local path to save the downloaded file to.")
+};
+async function downloadObjectSafe(params) {
+  try {
+    if (fs.existsSync(params.file_path)) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({
+              success: false,
+              error: `File already exists at path: ${params.file_path}`,
+              error_type: "AlreadyExists"
+            })
+          }
+        ]
+      };
+    }
+    const storage = apiClientFactory.getStorageClient();
+    await storage.bucket(params.bucket_name).file(params.object_name).download({ destination: params.file_path });
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            success: true,
+            message: `Object ${params.object_name} from bucket ${params.bucket_name} downloaded to ${params.file_path}.`
+          })
+        }
+      ]
+    };
+  } catch (e) {
+    const error2 = e;
+    logger.error(error2.message);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            success: false,
+            error: error2.message
+          })
+        }
+      ]
+    };
+  }
+}
+var registerDownloadObjectSafeTool = (server) => {
+  server.registerTool(
+    "download_object_safe",
+    {
+      description: "Downloads an object from GCS to a local file. Fails if the destination file already exists.",
+      inputSchema: inputSchema13
+    },
+    downloadObjectSafe
+  );
+};
+
+// src/tools/objects/list_objects.ts
+var inputSchema14 = {
   bucket_name: external_exports.string().describe("The name of the GCS bucket."),
   prefix: external_exports.string().optional().describe("Filters results to objects whose names begin with this prefix."),
   delimiter: external_exports.string().optional().describe(
@@ -27505,14 +27586,14 @@ var registerListObjectsTool = (server) => {
     "list_objects",
     {
       description: "Lists the names of objects in a Google Cloud Storage (GCS) bucket. Supports filtering by prefix, directory-like listing with a delimiter, pagination, and listing object versions.",
-      inputSchema: inputSchema13
+      inputSchema: inputSchema14
     },
     listObjects
   );
 };
 
 // src/tools/objects/move_object.ts
-var inputSchema14 = {
+var inputSchema15 = {
   source_bucket_name: external_exports.string().describe("The name of the source GCS bucket."),
   source_object_name: external_exports.string().describe("The name of the source object."),
   destination_bucket_name: external_exports.string().describe("The name of the destination GCS bucket."),
@@ -27566,7 +27647,7 @@ var registerMoveObjectTool = (server) => {
     "move_object",
     {
       description: "Moves an object from one bucket to another or renames it within the same bucket by copying and deleting the original.",
-      inputSchema: inputSchema14
+      inputSchema: inputSchema15
     },
     moveObject
   );
@@ -27709,7 +27790,7 @@ function detectBufferType(buffer, contentType, fileName) {
 
 // src/tools/objects/read_object_content.ts
 var { decode } = iconv;
-var inputSchema15 = {
+var inputSchema16 = {
   bucket_name: external_exports.string().describe("The name of the GCS bucket."),
   object_name: external_exports.string().describe("The name of the object.")
 };
@@ -27844,14 +27925,14 @@ var registerReadObjectContentTool = (server) => {
     "read_object_content",
     {
       description: "Reads the content of a specific object.",
-      inputSchema: inputSchema15
+      inputSchema: inputSchema16
     },
     readObjectContent
   );
 };
 
 // src/tools/objects/read_object_metadata.ts
-var inputSchema16 = {
+var inputSchema17 = {
   bucket_name: external_exports.string().describe("The name of the GCS bucket."),
   object_name: external_exports.string().describe("The name of the object.")
 };
@@ -27908,14 +27989,14 @@ var registerReadObjectMetadataTool = (server) => {
     "read_object_metadata",
     {
       description: "Reads metadata for a specific object.",
-      inputSchema: inputSchema16
+      inputSchema: inputSchema17
     },
     readObjectMetadata
   );
 };
 
 // src/tools/objects/update_object_metadata.ts
-var inputSchema17 = {
+var inputSchema18 = {
   bucket_name: external_exports.string().describe("The name of the GCS bucket."),
   object_name: external_exports.string().describe("The name of the object to update."),
   metadata: external_exports.record(external_exports.string()).describe("A dictionary of metadata to set on the object.")
@@ -27969,16 +28050,16 @@ var registerUpdateObjectMetadataTool = (server) => {
     "update_object_metadata",
     {
       description: "Updates the metadata of an existing object.",
-      inputSchema: inputSchema17
+      inputSchema: inputSchema18
     },
     updateObjectMetadata
   );
 };
 
 // src/tools/objects/upload_object.ts
-import * as fs from "fs";
+import * as fs2 from "fs";
 import * as path2 from "path";
-var inputSchema18 = {
+var inputSchema19 = {
   bucket_name: external_exports.string().describe("The name of the GCS bucket."),
   file_path: external_exports.string().describe("The local path of the file to upload."),
   object_name: external_exports.string().optional().describe(
@@ -27989,7 +28070,7 @@ var inputSchema18 = {
 async function uploadObject(params) {
   try {
     logger.info(`Uploading file: ${params.file_path} to bucket: ${params.bucket_name}`);
-    if (!fs.existsSync(params.file_path)) {
+    if (!fs2.existsSync(params.file_path)) {
       return {
         content: [
           {
@@ -28051,15 +28132,15 @@ var registerUploadObjectTool = (server) => {
     "upload_object",
     {
       description: "Uploads a file to a GCS bucket.",
-      inputSchema: inputSchema18
+      inputSchema: inputSchema19
     },
     uploadObject
   );
 };
 
 // src/tools/objects/upload_object_safe.ts
-import * as fs2 from "fs";
-var inputSchema19 = {
+import * as fs3 from "fs";
+var inputSchema20 = {
   bucket_name: external_exports.string().describe("The name of the GCS bucket."),
   file_path: external_exports.string().describe("The local path of the file to upload."),
   object_name: external_exports.string().optional().describe(
@@ -28070,7 +28151,7 @@ var inputSchema19 = {
 async function uploadObjectSafe(params) {
   try {
     logger.info(`Uploading safe file: ${params.file_path} to bucket: ${params.bucket_name}`);
-    if (!fs2.existsSync(params.file_path)) {
+    if (!fs3.existsSync(params.file_path)) {
       const errorMsg = `File not found at path: ${params.file_path}`;
       logger.error(errorMsg);
       return {
@@ -28093,7 +28174,7 @@ async function uploadObjectSafe(params) {
     }
     const file = bucket.file(objectName, { generation: 0 });
     const contentType = params.content_type || getContentType(params.file_path);
-    await file.save(fs2.readFileSync(params.file_path), {
+    await file.save(fs3.readFileSync(params.file_path), {
       contentType
     });
     const [metadata] = await file.getMetadata();
@@ -28138,14 +28219,14 @@ var registerUploadObjectSafeTool = (server) => {
     "upload_object_safe",
     {
       description: "Uploads a file to a GCS bucket. Fails if the object already exists.",
-      inputSchema: inputSchema19
+      inputSchema: inputSchema20
     },
     uploadObjectSafe
   );
 };
 
 // src/tools/objects/write_object.ts
-var inputSchema20 = {
+var inputSchema21 = {
   bucket_name: external_exports.string().describe("The name of the GCS bucket."),
   object_name: external_exports.string().describe("The name of the object to write."),
   content: external_exports.string().describe("The content to write to the object, encoded in base64."),
@@ -28217,14 +28298,14 @@ var registerWriteObjectTool = (server) => {
     "write_object",
     {
       description: "Writes a new object to the bucket.",
-      inputSchema: inputSchema20
+      inputSchema: inputSchema21
     },
     writeObject
   );
 };
 
 // src/tools/objects/write_object_safe.ts
-var inputSchema21 = {
+var inputSchema22 = {
   bucket_name: external_exports.string().describe("The name of the GCS bucket."),
   object_name: external_exports.string().describe("The name of the object to write."),
   content: external_exports.string().describe("The content to write to the object, encoded in base64."),
@@ -28303,7 +28384,7 @@ var registerWriteObjectSafeTool = (server) => {
     "write_object_safe",
     {
       description: "Writes a new object to the bucket. Fails if the object already exists.",
-      inputSchema: inputSchema21
+      inputSchema: inputSchema22
     },
     writeObjectSafe
   );
@@ -28311,7 +28392,7 @@ var registerWriteObjectSafeTool = (server) => {
 
 // src/tools/insights/get_metadata_table_schema.ts
 var serviceName = "storageinsights.googleapis.com";
-var inputSchema22 = {
+var inputSchema23 = {
   datasetConfigName: external_exports.string().describe("The name of the dataset configuration."),
   datasetConfigLocation: external_exports.string().describe("The location of the dataset configuration."),
   projectId: external_exports.string().optional().describe("The project ID to check Storage Insights availability for.")
@@ -28545,14 +28626,14 @@ var registerGetMetadataTableSchemaTool = (server) => {
     "get_metadata_table_schema",
     {
       description: "Checks if GCS insights service is enabled and returns the BigQuery table schema for a given insights dataset configuration in JSON format. Also returns hints for each column in the table",
-      inputSchema: inputSchema22
+      inputSchema: inputSchema23
     },
     getMetadataTableSchema
   );
 };
 
 // src/tools/insights/execute_insights_query.ts
-var inputSchema23 = {
+var inputSchema24 = {
   config: external_exports.string().describe(
     "The JSON object of the BigQuery table schema for a given insights dataset configuration."
   ),
@@ -28664,7 +28745,7 @@ var registerExecuteInsightsQueryTool = (server) => {
     "execute_insights_query",
     {
       description: "Executes a BigQuery SQL query against an insights dataset and returns the result.",
-      inputSchema: inputSchema23
+      inputSchema: inputSchema24
     },
     executeInsightsQuery
   );
@@ -28672,7 +28753,7 @@ var registerExecuteInsightsQueryTool = (server) => {
 
 // src/tools/insights/list_insights_configs.ts
 var serviceName2 = "storageinsights.googleapis.com";
-var inputSchema24 = {
+var inputSchema25 = {
   projectId: external_exports.string().optional().describe("The project ID to list Storage Insights dataset configurations for.")
 };
 async function listInsightsConfigs(params) {
@@ -28737,7 +28818,7 @@ var registerListInsightsConfigsTool = (server) => {
     "list_insights_configs",
     {
       description: "Lists the names of all Storage Insights dataset configurations for a given project.",
-      inputSchema: inputSchema24
+      inputSchema: inputSchema25
     },
     listInsightsConfigs
   );
@@ -28754,7 +28835,7 @@ var commonSafeTools = [
   registerListObjectsTool,
   registerReadObjectContentTool,
   registerReadObjectMetadataTool,
-  registerDownloadObjectTool,
+  registerDownloadObjectSafeTool,
   registerDeleteObjectTool,
   registerGetMetadataTableSchemaTool,
   registerExecuteInsightsQueryTool,
@@ -28774,7 +28855,8 @@ var otherDestructiveTools = [
   registerDeleteBucketTool,
   registerUpdateBucketLabelsTool,
   registerMoveObjectTool,
-  registerUpdateObjectMetadataTool
+  registerUpdateObjectMetadataTool,
+  registerDownloadObjectTool
 ];
 
 // ../../node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
@@ -28872,7 +28954,7 @@ var StdioServerTransport = class {
 // package.json
 var package_default = {
   name: "@google-cloud/storage-mcp",
-  version: "0.3.3",
+  version: "0.4.0",
   type: "module",
   main: "dist/bundle.js",
   bin: {
@@ -28922,7 +29004,7 @@ var package_default = {
     eslint: "^9.32.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-license-header": "^0.8.0",
+    "eslint-plugin-license-header": "^0.9.0",
     "eslint-plugin-prettier": "^5.5.4",
     prettier: "^3.6.2",
     turbo: "latest",
@@ -28933,7 +29015,7 @@ var package_default = {
   dependencies: {
     "@google-cloud/bigquery": "^8.0.0",
     "@google-cloud/service-usage": "^4.2.0",
-    "@google-cloud/storage": "^7.17.1",
+    "@google-cloud/storage": "^7.19.0",
     "@google-cloud/storageinsights": "^2.2.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "@types/yargs": "^17.0.33",
@@ -34314,10 +34396,10 @@ For example, you can use the tools to:
 ## GCS Reference Documentation
 
 If additional context or information is needed on GCS, reference documentation can be found at https://cloud.google.com/storage/docs.`;
-var initializeGeminiCLI = async (local = false, enableDestructiveTools = false, fs3 = { mkdir, writeFile: writeFile2 }) => {
+var initializeGeminiCLI = async (local = false, enableDestructiveTools = false, fs4 = { mkdir, writeFile: writeFile2 }) => {
   try {
     const extensionDir = join2(os.homedir(), ".gemini", "extensions", "storage-mcp");
-    await fs3.mkdir(extensionDir, { recursive: true });
+    await fs4.mkdir(extensionDir, { recursive: true });
     const extensionFile = join2(extensionDir, "gemini-extension.json");
     const commandArgs = local ? ["-y", "storage-mcp"] : ["-y", "@google-cloud/storage-mcp"];
     if (enableDestructiveTools) {
@@ -34335,10 +34417,10 @@ var initializeGeminiCLI = async (local = false, enableDestructiveTools = false,
         }
       }
     };
-    await fs3.writeFile(extensionFile, JSON.stringify(extensionJson, null, 2));
+    await fs4.writeFile(extensionFile, JSON.stringify(extensionJson, null, 2));
     console.log(`Created: ${extensionFile}`);
     const geminiMdDestPath = join2(extensionDir, "GEMINI.md");
-    await fs3.writeFile(geminiMdDestPath, geminiMdContent);
+    await fs4.writeFile(geminiMdDestPath, geminiMdContent);
     console.log(`Created: ${geminiMdDestPath}`);
     console.log(`\u{1F331} storage-mcp Gemini CLI extension initialized.`);
   } catch (err) {