@gcnv/gcnv-mcp-server 1.0.3

package/build/tools/storage-pool-tools.js

@@ -0,0 +1,215 @@
+import { z } from 'zod';
+// Create Storage Pool Tool
+export const createStoragePoolTool = {
+    name: 'gcnv_storage_pool_create',
+    title: 'Create Storage Pool',
+    description: 'Creates a new storage pool in the specified project and location',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location where the storage pool should be created'),
+        storagePoolId: z.string().describe('The ID to assign to the storage pool'),
+        capacityGib: z.number().describe('The capacity of the storage pool in GiB'),
+        serviceLevel: z
+            .enum(['STANDARD', 'PREMIUM', 'EXTREME'])
+            .describe('The service level of the storage pool'),
+        description: z.string().optional().describe('Optional description of the storage pool'),
+        labels: z
+            .record(z.string())
+            .optional()
+            .describe('Optional labels to apply to the storage pool'),
+        network: z
+            .string()
+            .optional()
+            .describe('The VPC network to use for the storage pool (projects/{project}/global/networks/{network})'),
+        activeDirectory: z
+            .string()
+            .optional()
+            .describe('The Active Directory policy resource to attach to SMB volumes'),
+        kmsConfig: z
+            .string()
+            .optional()
+            .describe('The CMEK KMS config to use for pool encryption (projects/{project}/locations/{location}/kmsConfigs/{kmsConfigId})'),
+        encryptionType: z
+            .enum(['SERVICE_MANAGED', 'CLOUD_KMS'])
+            .optional()
+            .describe('Encryption type for the pool; use CLOUD_KMS with kmsConfig'),
+        ldapEnabled: z
+            .boolean()
+            .optional()
+            .describe('Whether LDAP should be enabled for NFS volume access'),
+        psaRange: z
+            .string()
+            .optional()
+            .describe('CIDR range for Private Service Access allocated to the pool'),
+        globalAccessAllowed: z
+            .boolean()
+            .optional()
+            .describe('Allow clients from other regions to access volumes in this pool'),
+        allowAutoTiering: z
+            .boolean()
+            .optional()
+            .describe('Enable auto-tiering to manage capacity for the pool'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the created storage pool'),
+        operationId: z
+            .string()
+            .describe('The ID of the long-running operation for creating the storage pool'),
+    },
+};
+// Delete Storage Pool Tool
+export const deleteStoragePoolTool = {
+    name: 'gcnv_storage_pool_delete',
+    title: 'Delete Storage Pool',
+    description: 'Deletes a storage pool in the specified project and location',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the storage pool'),
+        storagePoolId: z.string().describe('The ID of the storage pool to delete'),
+        force: z.boolean().optional().describe('Force deletion even if the pool contains resources'),
+    },
+    outputSchema: {
+        success: z.boolean().describe('Whether the deletion was successful'),
+        operationId: z.string().optional().describe('The ID of the long-running operation'),
+    },
+};
+// Get Storage Pool Tool
+export const getStoragePoolTool = {
+    name: 'gcnv_storage_pool_get',
+    title: 'Get Storage Pool',
+    description: 'Gets details of a specific storage pool',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the storage pool'),
+        storagePoolId: z.string().describe('The ID of the storage pool to retrieve'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the storage pool'),
+        storagePoolId: z.string().describe('The ID of the storage pool'),
+        serviceLevel: z.string().describe('The service level of the storage pool'),
+        capacityGib: z.number().describe('The capacity of the storage pool in GiB'),
+        volumeCapacityGib: z.number().describe('The total volume capacity in GiB'),
+        volumecount: z.number().describe('The number of volumes in the storage pool'),
+        state: z.string().describe('The current state of the storage pool'),
+        createTime: z.date().describe('The timestamp when the storage pool was created'),
+        description: z.string().optional().describe('The description of the storage pool'),
+        labels: z.record(z.string()).optional().describe('Labels applied to the storage pool'),
+        network: z.string().optional().describe('The VPC network used by the storage pool'),
+        activeDirectory: z
+            .string()
+            .optional()
+            .describe('The Active Directory policy attached to SMB volumes'),
+        kmsConfig: z.string().optional().describe('The CMEK KMS config applied to the pool'),
+        encryptionType: z.string().optional().describe('The encryption type configured for the pool'),
+        ldapEnabled: z.boolean().optional().describe('Whether LDAP is enabled for NFS volume access'),
+        psaRange: z
+            .string()
+            .optional()
+            .describe('CIDR range for Private Service Access allocated to the pool'),
+        globalAccessAllowed: z
+            .boolean()
+            .optional()
+            .describe('Indicates if cross-region volume access is allowed'),
+        allowAutoTiering: z
+            .boolean()
+            .optional()
+            .describe('Whether auto-tiering is enabled for the pool'),
+    },
+};
+// List Storage Pools Tool
+export const listStoragePoolsTool = {
+    name: 'gcnv_storage_pool_list',
+    title: 'List Storage Pools',
+    description: 'Lists all storage pools in the specified project and location',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location to list storage pools from'),
+        filter: z.string().optional().describe('Filter expression for filtering results'),
+        pageSize: z.number().optional().describe('The maximum number of storage pools to return'),
+        pageToken: z.string().optional().describe('Page token from a previous list request'),
+    },
+    outputSchema: {
+        storagePools: z
+            .array(z.object({
+            name: z.string().describe('The name of the storage pool'),
+            storagePoolId: z.string().describe('The ID of the storage pool'),
+            serviceLevel: z.string().describe('The service level of the storage pool'),
+            capacityGib: z.number().describe('The capacity of the storage pool in GiB'),
+            volumeCapacityGib: z.number().describe('The total volume capacity in GiB'),
+            volumecount: z.number().describe('The number of volumes in the storage pool'),
+            state: z.string().describe('The current state of the storage pool'),
+            createTime: z.date().describe('The timestamp when the storage pool was created'),
+            description: z.string().optional().describe('The description of the storage pool'),
+            labels: z.record(z.string()).optional().describe('Labels applied to the storage pool'),
+            network: z.string().optional().describe('The VPC network used by the storage pool'),
+            activeDirectory: z
+                .string()
+                .optional()
+                .describe('The Active Directory policy attached to SMB volumes'),
+            kmsConfig: z.string().optional().describe('The CMEK KMS config applied to the pool'),
+            encryptionType: z
+                .string()
+                .optional()
+                .describe('The encryption type configured for the pool'),
+            ldapEnabled: z
+                .boolean()
+                .optional()
+                .describe('Whether LDAP is enabled for NFS volume access'),
+            psaRange: z
+                .string()
+                .optional()
+                .describe('CIDR range for Private Service Access allocated to the pool'),
+            globalAccessAllowed: z
+                .boolean()
+                .optional()
+                .describe('Indicates if cross-region volume access is allowed'),
+            allowAutoTiering: z
+                .boolean()
+                .optional()
+                .describe('Whether auto-tiering is enabled for the pool'),
+        }))
+            .describe('List of storage pools'),
+        nextPageToken: z.string().optional().describe('Token to retrieve the next page of results'),
+    },
+};
+// Update Storage Pool Tool
+export const updateStoragePoolTool = {
+    name: 'gcnv_storage_pool_update',
+    title: 'Update Storage Pool',
+    description: 'Updates a storage pool in the specified project and location',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the storage pool'),
+        storagePoolId: z.string().describe('The ID of the storage pool to update'),
+        capacityGib: z.number().optional().describe('The new capacity of the storage pool in GiB'),
+        description: z.string().optional().describe('New description of the storage pool'),
+        labels: z.record(z.string()).optional().describe('New labels to apply to the storage pool'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the updated storage pool'),
+        operationId: z
+            .string()
+            .optional()
+            .describe('The ID of the long-running operation for updating the storage pool'),
+    },
+};
+// Validate Directory Service Tool
+export const validateDirectoryServiceTool = {
+    name: 'gcnv_storage_pool_validate_directory_service',
+    title: 'Validate Directory Service',
+    description: 'Validates directory service policy attached to a storage pool',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the storage pool'),
+        storagePoolId: z.string().describe('The ID of the storage pool'),
+        directoryServiceType: z
+            .enum(['ACTIVE_DIRECTORY', 'LDAP'])
+            .describe('Type of directory service policy attached to the storage pool'),
+    },
+    outputSchema: {
+        success: z.boolean().describe('Whether the validation was successful'),
+        operationId: z
+            .string()
+            .describe('The ID of the long-running operation for validating directory service'),
+    },
+};

package/build/tools/volume-tools.js

@@ -0,0 +1,216 @@
+import { z } from 'zod';
+// Create Volume Tool
+export const createVolumeTool = {
+    name: 'gcnv_volume_create',
+    title: 'Create Volume',
+    description: 'Creates a new volume in the specified storage pool',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location where the volume should be created'),
+        storagePoolId: z.string().describe('The ID of the storage pool to create the volume in'),
+        volumeId: z.string().describe('The ID to assign to the volume'),
+        capacityGib: z.number().describe('The capacity of the volume in GiB'),
+        protocols: z
+            .array(z.enum(['NFSV3', 'NFSV4', 'SMB', 'DUAL']))
+            .describe('The file share protocols to enable'),
+        description: z.string().optional().describe('Optional description of the volume'),
+        shareName: z.string().optional().describe('Optional name of the file share'),
+        labels: z.record(z.string()).optional().describe('Optional labels to apply to the volume'),
+        backupConfig: z
+            .object({
+            backupPolicies: z
+                .array(z.string())
+                .optional()
+                .describe('Backup policy resource names (projects/.../backupPolicies/ID)'),
+            backupVault: z
+                .string()
+                .optional()
+                .describe('Backup vault resource name (projects/.../backupVaults/ID)'),
+            scheduledBackupEnabled: z.boolean().optional().describe('Enable scheduled backups'),
+        })
+            .optional()
+            .describe('Backup configuration'),
+        exportPolicy: z
+            .object({
+            rules: z
+                .array(z.object({
+                allowedClients: z.string().describe('CIDR range of client IPs to allow'),
+                accessType: z
+                    .enum(['READ_ONLY', 'READ_WRITE'])
+                    .optional()
+                    .describe('Access permission type'),
+                nfsv3: z.boolean().optional().describe('Whether NFSv3 is allowed'),
+                nfsv4: z.boolean().optional().describe('Whether NFSv4 is allowed'),
+                hasRootAccess: z.boolean().optional().describe('Whether root access is allowed'),
+                nfsOptions: z
+                    .object({
+                    rootSquash: z.boolean().optional().describe('Whether to enable root squashing'),
+                    anon: z.string().optional().describe('Anonymous user ID for mapped root user'),
+                })
+                    .optional()
+                    .describe('NFS-specific options'),
+                kerberos5ReadOnly: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether Kerberos5 is required for read-only operations'),
+                kerberos5ReadWrite: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether Kerberos5 is required for read-write operations'),
+                kerberos5iReadOnly: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether Kerberos5i is required for read-only operations'),
+                kerberos5iReadWrite: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether Kerberos5i is required for read-write operations'),
+                kerberos5pReadOnly: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether Kerberos5p is required for read-only operations'),
+                kerberos5pReadWrite: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether Kerberos5p is required for read-write operations'),
+            }))
+                .describe('List of export policy rules'),
+        })
+            .optional()
+            .describe('NFS export policy configuration'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the created volume'),
+        operationId: z
+            .string()
+            .describe('The ID of the long-running operation for creating the volume'),
+    },
+};
+// Delete Volume Tool
+export const deleteVolumeTool = {
+    name: 'gcnv_volume_delete',
+    title: 'Delete Volume',
+    description: 'Deletes a volume in the specified storage pool',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the volume'),
+        volumeId: z.string().describe('The ID of the volume to delete'),
+        force: z.boolean().optional().describe('Force deletion even if the volume has snapshots'),
+    },
+    outputSchema: {
+        success: z.boolean().describe('Whether the deletion was successful'),
+        operationId: z.string().optional().describe('The ID of the long-running operation'),
+    },
+};
+// Get Volume Tool
+export const getVolumeTool = {
+    name: 'gcnv_volume_get',
+    title: 'Get Volume',
+    description: 'Gets details of a specific volume',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the volume'),
+        volumeId: z.string().describe('The ID of the volume to retrieve'),
+    },
+    // Allow any additional fields from the API
+    outputSchema: {
+        volume: z.record(z.any()).describe('Volume details'),
+    },
+};
+// List Volumes Tool
+export const listVolumesTool = {
+    name: 'gcnv_volume_list',
+    title: 'List Volumes',
+    description: 'Lists all volumes in the specified storage pool',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location to list volumes from'),
+        filter: z.string().optional().describe('Filter expression for filtering results'),
+        pageSize: z.number().optional().describe('The maximum number of volumes to return'),
+        pageToken: z.string().optional().describe('Page token from a previous list request'),
+    },
+    outputSchema: {
+        volumes: z.array(z.record(z.any())).describe('List of volumes'),
+        nextPageToken: z.string().optional().describe('Token to retrieve the next page of results'),
+    },
+};
+// Update Volume Tool
+export const updateVolumeTool = {
+    name: 'gcnv_volume_update',
+    title: 'Update Volume',
+    description: 'Updates a volume in the specified storage pool',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the volume'),
+        volumeId: z.string().describe('The ID of the volume to update'),
+        capacityGib: z.number().optional().describe('The new capacity of the volume in GiB'),
+        description: z.string().optional().describe('New description of the volume'),
+        labels: z.record(z.string()).optional().describe('New labels to apply to the volume'),
+        backupConfig: z
+            .object({
+            backupPolicies: z
+                .array(z.string())
+                .describe('Backup policy resource names (projects/.../backupPolicies/ID)'),
+            backupVault: z
+                .string()
+                .describe('Backup vault resource name (projects/.../backupVaults/ID)'),
+            scheduledBackupEnabled: z.boolean().describe('Enable scheduled backups'),
+        })
+            .optional()
+            .describe('Backup configuration'),
+        exportPolicy: z
+            .object({
+            rules: z
+                .array(z.object({
+                allowedClients: z.string().optional().describe('CIDR range of client IPs to allow'),
+                accessType: z
+                    .enum(['READ_ONLY', 'READ_WRITE'])
+                    .optional()
+                    .describe('Access permission type'),
+                nfsv3: z.boolean().optional().describe('Whether NFSv3 is allowed'),
+                nfsv4: z.boolean().optional().describe('Whether NFSv4 is allowed'),
+                nfsOptions: z
+                    .object({
+                    rootSquash: z.boolean().optional().describe('Whether to enable root squashing'),
+                    anon: z.string().optional().describe('Anonymous user ID for mapped root user'),
+                })
+                    .optional()
+                    .describe('NFS-specific options'),
+                kerberos5ReadOnly: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether Kerberos5 is required for read-only operations'),
+                kerberos5ReadWrite: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether Kerberos5 is required for read-write operations'),
+                kerberos5iReadOnly: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether Kerberos5i is required for read-only operations'),
+                kerberos5iReadWrite: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether Kerberos5i is required for read-write operations'),
+                kerberos5pReadOnly: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether Kerberos5p is required for read-only operations'),
+                kerberos5pReadWrite: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether Kerberos5p is required for read-write operations'),
+            }))
+                .describe('List of export policy rules'),
+        })
+            .optional()
+            .describe('Updated NFS export policy configuration'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the updated volume'),
+        operationId: z
+            .string()
+            .optional()
+            .describe('The ID of the long-running operation for updating the volume'),
+    },
+};

package/build/types/tool.js

@@ -0,0 +1 @@
+export {};

package/build/utils/netapp-client-factory.js

@@ -0,0 +1,53 @@
+import { NetAppClient } from '@google-cloud/netapp';
+/**
+ * Factory class for creating NetAppClient instances
+ * This centralizes client creation and allows for easier testing and configuration
+ */
+export class NetAppClientFactory {
+    // Cache for storing client instances (singleton pattern)
+    static clientCache = {};
+    // Default configuration that will be used if no specific options are provided
+    static defaultConfig;
+    /**
+     * Create a new NetAppClient instance
+     *
+     * @param options - Options for the NetApp client, will override default config if both exist
+     * @param cacheKey - Optional key for caching the client instance
+     * @returns A configured NetAppClient instance
+     */
+    static createClient(options, cacheKey) {
+        // If a cache key is provided and a client exists, return the cached client
+        if (cacheKey && this.clientCache[cacheKey]) {
+            return this.clientCache[cacheKey];
+        }
+        // Merge default config with provided options, with options taking precedence
+        let mergedOptions;
+        if (this.defaultConfig || options) {
+            mergedOptions = {
+                ...(this.defaultConfig || {}),
+                ...(options || {}),
+            };
+        }
+        // Create a new client with the merged options
+        const client = mergedOptions ? new NetAppClient(mergedOptions) : new NetAppClient();
+        // If a cache key is provided, store the client for future use
+        if (cacheKey) {
+            this.clientCache[cacheKey] = client;
+        }
+        return client;
+    }
+    /**
+     * Clear the client cache
+     * Useful for testing or when configuration changes
+     */
+    static clearCache() {
+        this.clientCache = {};
+    }
+    /**
+     * Reset the factory to its initial state
+     * Clears both the cache and default configuration
+     */
+    static reset() {
+        this.clearCache();
+    }
+}

package/gemini-extension.json

@@ -0,0 +1,12 @@
+{
+  "name": "gcnv-mcp",
+  "version": "1.0.0",
+  "contextFileName": "GEMINI.md",
+  "mcpServers": {
+    "gcnv-mcp": {
+      "command": "npx",
+      "transport": "jsonrpc",
+      "args": ["@gcnv/gcnv-mcp-server@latest"]
+    }
+  }
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@gcnv/gcnv-mcp-server",
+  "version": "1.0.3",
+  "description": "Google Cloud NetApp Volumes MCP Server - A Model Context Protocol server for managing GCNV Backup, StoragePool, Volume and Replication resources",
+  "main": "build/index.js",
+  "bin": {
+    "gcnv-mcp": "build/index.js"
+  },
+  "files": [
+    "build",
+    "GEMINI.md",
+    "gemini-extension.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prepack": "npm run build",
+    "build": "npm run lint && npm run format && tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --ext .ts --max-warnings=0",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "format": "prettier --check .",
+    "format:fix": "prettier --write .",
+    "start": "node build/index.js",
+    "start:stdio": "node build/index.js --transport stdio",
+    "start:http": "node build/index.js --transport http",
+    "dev": "tsx src/index.ts",
+    "dev:http": "tsx src/index.ts --transport http"
+  },
+  "keywords": [
+    "mcp",
+    "google",
+    "netapp",
+    "ontap",
+    "storage",
+    "api"
+  ],
+  "author": "",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.1.0",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.1",
+    "prettier": "^3.4.1",
+    "tsx": "^4.19.1",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.48.0"
+  },
+  "dependencies": {
+    "@google-cloud/netapp": "^0.15.0",
+    "@google-cloud/local-auth": "3.0.1",
+    "@modelcontextprotocol/sdk": "^1.20.1",
+    "axios": "^1.6.3",
+    "pino": "^9.5.0",
+    "pino-pretty": "^11.3.0",
+    "zod": "^3.25.76"
+  }
+}