@gcnv/gcnv-mcp-server 1.0.3

package/build/tools/quota-rule-tools.js

@@ -0,0 +1,166 @@
+import { z } from 'zod';
+// Create Quota Rule Tool
+export const createQuotaRuleTool = {
+    name: 'gcnv_quota_rule_create',
+    title: 'Create Quota Rule',
+    description: 'Creates a new quota rule for a 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'),
+        quotaRuleId: z.string().describe('The ID to assign to the quota rule'),
+        target: z.string().describe('The POSIX user/group this rule targets'),
+        // Accept either enum name or numeric value
+        quotaType: z
+            .union([
+            z.enum([
+                'TYPE_UNSPECIFIED',
+                'INDIVIDUAL_USER_QUOTA',
+                'INDIVIDUAL_GROUP_QUOTA',
+                'DEFAULT_USER_QUOTA',
+                'DEFAULT_GROUP_QUOTA',
+            ]),
+            z.number(),
+        ])
+            .describe('Quota rule type (enum name or number)'),
+        // Temporary alias to allow callers to pass 'type' directly
+        type: z
+            .union([
+            z.enum([
+                'TYPE_UNSPECIFIED',
+                'INDIVIDUAL_USER_QUOTA',
+                'INDIVIDUAL_GROUP_QUOTA',
+                'DEFAULT_USER_QUOTA',
+                'DEFAULT_GROUP_QUOTA',
+            ]),
+            z.number(),
+        ])
+            .optional()
+            .describe('Quota rule type (enum name or number)'),
+        diskLimitMib: z.number().describe('Quota size in MiB'),
+        description: z.string().optional().describe('Optional description'),
+        labels: z.record(z.string()).optional().describe('Optional labels'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the created quota rule'),
+        operationId: z.string().describe('The ID of the long-running operation'),
+    },
+};
+// Delete Quota Rule Tool
+export const deleteQuotaRuleTool = {
+    name: 'gcnv_quota_rule_delete',
+    title: 'Delete Quota Rule',
+    description: 'Deletes a quota rule',
+    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'),
+        quotaRuleId: z.string().describe('The ID of the quota rule to delete'),
+    },
+    outputSchema: {
+        success: z.boolean().describe('Whether the deletion was successful'),
+        operationId: z.string().optional().describe('The ID of the long-running operation'),
+    },
+};
+// Get Quota Rule Tool
+export const getQuotaRuleTool = {
+    name: 'gcnv_quota_rule_get',
+    title: 'Get Quota Rule',
+    description: 'Gets details of a specific quota rule',
+    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'),
+        quotaRuleId: z.string().describe('The ID of the quota rule to retrieve'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the quota rule'),
+        quotaRuleId: z.string().describe('The ID of the quota rule'),
+        target: z.string().optional().describe('The POSIX user/group this rule targets'),
+        quotaType: z.number().optional().describe('Type of quota rule (enum number)'),
+        type: z.number().optional().describe('Type of quota rule (enum number)'),
+        diskLimitMib: z.number().optional().describe('Quota size in MiB'),
+        state: z.string().optional().describe('The current state'),
+        createTime: z.date().optional().describe('The creation timestamp'),
+        description: z.string().optional().describe('Description'),
+        labels: z.record(z.string()).optional().describe('Labels'),
+    },
+};
+// List Quota Rules Tool
+export const listQuotaRulesTool = {
+    name: 'gcnv_quota_rule_list',
+    title: 'List Quota Rules',
+    description: 'Lists all quota rules for a 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'),
+        filter: z.string().optional().describe('Filter expression'),
+        pageSize: z.number().optional().describe('Maximum number of items to return'),
+        pageToken: z.string().optional().describe('Page token from previous request'),
+        orderBy: z.string().optional().describe('Sort order'),
+    },
+    outputSchema: {
+        quotaRules: z
+            .array(z.object({
+            name: z.string().describe('The name of the quota rule'),
+            quotaRuleId: z.string().describe('The ID of the quota rule'),
+            target: z.string().optional().describe('The POSIX user/group this rule targets'),
+            quotaType: z.number().optional().describe('Type of quota rule (enum number)'),
+            type: z.number().optional().describe('Type of quota rule (enum number)'),
+            diskLimitMib: z.number().optional().describe('Quota size in MiB'),
+            state: z.string().optional().describe('The current state'),
+            createTime: z.date().optional().describe('The creation timestamp'),
+            description: z.string().optional().describe('Description'),
+            labels: z.record(z.string()).optional().describe('Labels'),
+        }))
+            .describe('List of quota rules'),
+        nextPageToken: z.string().optional().describe('Token for next page'),
+    },
+};
+// Update Quota Rule Tool
+export const updateQuotaRuleTool = {
+    name: 'gcnv_quota_rule_update',
+    title: 'Update Quota Rule',
+    description: 'Updates a quota rule',
+    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'),
+        quotaRuleId: z.string().describe('The ID of the quota rule to update'),
+        target: z.string().optional().describe('The POSIX user/group this rule targets'),
+        quotaType: z
+            .union([
+            z.enum([
+                'TYPE_UNSPECIFIED',
+                'INDIVIDUAL_USER_QUOTA',
+                'INDIVIDUAL_GROUP_QUOTA',
+                'DEFAULT_USER_QUOTA',
+                'DEFAULT_GROUP_QUOTA',
+            ]),
+            z.number(),
+        ])
+            .optional()
+            .describe('Type of quota rule (enum name or number)'),
+        type: z
+            .union([
+            z.enum([
+                'TYPE_UNSPECIFIED',
+                'INDIVIDUAL_USER_QUOTA',
+                'INDIVIDUAL_GROUP_QUOTA',
+                'DEFAULT_USER_QUOTA',
+                'DEFAULT_GROUP_QUOTA',
+            ]),
+            z.number(),
+        ])
+            .optional()
+            .describe('Type of quota rule (enum name or number)'),
+        diskLimitMib: z.number().optional().describe('Quota size in MiB'),
+        description: z.string().optional().describe('New description'),
+        labels: z.record(z.string()).optional().describe('New labels'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the updated quota rule'),
+        operationId: z.string().describe('The ID of the long-running operation'),
+    },
+};

package/build/tools/replication-tools.js

@@ -0,0 +1,227 @@
+import { z } from 'zod';
+// Create Replication Tool
+export const createReplicationTool = {
+    name: 'gcnv_replication_create',
+    title: 'Create Replication',
+    description: 'Creates a new replication between volumes. Only supported region pairs/region-groups are allowed; see https://docs.cloud.google.com/netapp/volumes/docs/protect-data/about-volume-replication',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location where the replication should be created'),
+        replicationId: z.string().describe('The ID to assign to the replication'),
+        sourceVolumeId: z.string().describe('The ID of the source volume to replicate from'),
+        destinationStoragePool: z.string().describe('The full path of destination storage pool'),
+        replicationSchedule: z
+            .enum(['EVERY_10_MINUTES', 'HOURLY', 'DAILY'])
+            .default('HOURLY')
+            .describe('Replication schedule; defaults to HOURLY'),
+        description: z.string().optional().describe('Optional description of the replication'),
+        labels: z.record(z.string()).optional().describe('Optional labels to apply to the replication'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the created replication'),
+        operationId: z
+            .string()
+            .describe('The ID of the long-running operation for creating the replication'),
+    },
+};
+// Delete Replication Tool
+export const deleteReplicationTool = {
+    name: 'gcnv_replication_delete',
+    title: 'Delete Replication',
+    description: 'Deletes a replication configuration',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the replication'),
+        volumeId: z.string().describe('The ID of the volume containing the replication'),
+        replicationId: z.string().describe('The ID of the replication to delete'),
+    },
+    outputSchema: {
+        success: z.boolean().describe('Whether the deletion was successful'),
+        operationId: z.string().optional().describe('The ID of the long-running operation'),
+    },
+};
+// Get Replication Tool
+export const getReplicationTool = {
+    name: 'gcnv_replication_get',
+    title: 'Get Replication',
+    description: 'Gets details of a specific replication',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the replication'),
+        volumeId: z.string().describe('The ID of the volume containing the replication'),
+        replicationId: z.string().describe('The ID of the replication to retrieve'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the replication'),
+        replicationId: z.string().describe('The ID of the replication'),
+        sourceVolume: z.string().describe('The source volume of the replication'),
+        destinationVolume: z.string().describe('The destination volume of the replication'),
+        state: z.string().describe('The current state of the replication'),
+        createTime: z.date().describe('The timestamp when the replication was created'),
+        description: z.string().optional().describe('The description of the replication'),
+        labels: z.record(z.string()).optional().describe('Labels applied to the replication'),
+        healthy: z.boolean().describe('Whether the replication is healthy'),
+        lastReplicationTime: z
+            .date()
+            .optional()
+            .describe('The timestamp of the last successful replication'),
+    },
+};
+// List Replications Tool
+export const listReplicationsTool = {
+    name: 'gcnv_replication_list',
+    title: 'List Replications',
+    description: 'Lists all replications in the specified location',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location to list replications from'),
+        volumeId: z.string().describe('The ID of the volume for which the replications are listed'),
+        filter: z.string().optional().describe('Filter expression for filtering results'),
+        pageSize: z.number().optional().describe('The maximum number of replications to return'),
+        pageToken: z.string().optional().describe('Page token from a previous list request'),
+    },
+    outputSchema: {
+        replications: z
+            .array(z.object({
+            name: z.string().describe('The name of the replication'),
+            replicationId: z.string().describe('The ID of the replication'),
+            sourceVolume: z.string().describe('The source volume of the replication'),
+            destinationVolume: z.string().describe('The destination volume of the replication'),
+            state: z.string().describe('The current state of the replication'),
+            createTime: z.date().describe('The timestamp when the replication was created'),
+            description: z.string().optional().describe('The description of the replication'),
+            labels: z.record(z.string()).optional().describe('Labels applied to the replication'),
+            healthy: z.boolean().describe('Whether the replication is healthy'),
+            lastReplicationTime: z
+                .date()
+                .optional()
+                .describe('The timestamp of the last successful replication'),
+        }))
+            .describe('List of replications'),
+        nextPageToken: z.string().optional().describe('Token to retrieve the next page of results'),
+    },
+};
+// Update Replication Tool
+export const updateReplicationTool = {
+    name: 'gcnv_replication_update',
+    title: 'Update Replication',
+    description: 'Updates a replication configuration',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the replication'),
+        volumeId: z.string().describe('The ID of the volume containing the replication'),
+        replicationId: z.string().describe('The ID of the replication to update'),
+        description: z.string().optional().describe('New description of the replication'),
+        labels: z.record(z.string()).optional().describe('New labels to apply to the replication'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the updated replication'),
+        operationId: z
+            .string()
+            .optional()
+            .describe('The ID of the long-running operation for updating the replication'),
+    },
+};
+// Resume Replication Tool
+export const resumeReplicationTool = {
+    name: 'gcnv_replication_resume',
+    title: 'Resume Replication',
+    description: 'Resumes a paused replication',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the replication'),
+        volumeId: z.string().describe('The ID of the volume containing the replication'),
+        replicationId: z.string().describe('The ID of the replication to resume'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the replication'),
+        operationId: z
+            .string()
+            .describe('The ID of the long-running operation for resuming the replication'),
+    },
+};
+// Stop Replication Tool
+export const stopReplicationTool = {
+    name: 'gcnv_replication_stop',
+    title: 'Stop Replication',
+    description: 'Stops an active replication',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the replication'),
+        volumeId: z.string().describe('The ID of the volume containing the replication'),
+        replicationId: z.string().describe('The ID of the replication to stop'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the replication'),
+        operationId: z
+            .string()
+            .describe('The ID of the long-running operation for stopping the replication'),
+    },
+};
+// Reverse Replication Direction Tool
+export const reverseReplicationDirectionTool = {
+    name: 'gcnv_replication_reverse_direction',
+    title: 'Reverse Replication Direction',
+    description: 'Reverses the direction of an existing replication',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the replication'),
+        volumeId: z.string().describe('The ID of the volume containing the replication'),
+        replicationId: z.string().describe('The ID of the replication to reverse'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the replication'),
+        operationId: z
+            .string()
+            .describe('The ID of the long-running operation for reversing the replication direction'),
+    },
+};
+// Establish Peering Tool
+export const establishPeeringTool = {
+    name: 'gcnv_replication_establish_peering',
+    title: 'Establish Replication Peering',
+    description: 'Establishes replication peering between clusters',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the replication'),
+        volumeId: z.string().describe('The ID of the volume containing the replication'),
+        replicationId: z.string().describe('The ID of the replication'),
+        peerClusterName: z
+            .string()
+            .describe("Name of the user's local source cluster to be peered with the destination cluster"),
+        peerSvmName: z
+            .string()
+            .describe("Name of the user's local source vserver svm to be peered with the destination vserver svm"),
+        peerVolumeName: z
+            .string()
+            .describe("Name of the user's local source volume to be peered with the destination volume"),
+        peerIpAddresses: z
+            .array(z.string())
+            .optional()
+            .describe('Optional list of IPv4 ip addresses to be used for peering'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the replication'),
+        operationId: z
+            .string()
+            .describe('The ID of the long-running operation for establishing peering'),
+    },
+};
+// Sync Replication Tool
+export const syncReplicationTool = {
+    name: 'gcnv_replication_sync',
+    title: 'Sync Replication',
+    description: 'Syncs the replication - invokes one time volume data transfer from source to destination',
+    inputSchema: {
+        projectId: z.string().describe('The ID of the Google Cloud project'),
+        location: z.string().describe('The location of the replication'),
+        volumeId: z.string().describe('The ID of the volume containing the replication'),
+        replicationId: z.string().describe('The ID of the replication to sync'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the replication'),
+        operationId: z
+            .string()
+            .describe('The ID of the long-running operation for syncing the replication'),
+    },
+};

package/build/tools/snapshot-tools.js

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+// Create Snapshot Tool
+export const createSnapshotTool = {
+    name: 'gcnv_snapshot_create',
+    title: 'Create Snapshot',
+    description: 'Creates a new snapshot of the specified 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 snapshot'),
+        snapshotId: z.string().describe('The ID to assign to the snapshot'),
+        description: z.string().optional().describe('Optional description of the snapshot'),
+        labels: z.record(z.string()).optional().describe('Optional labels to apply to the snapshot'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the created snapshot'),
+        operationId: z
+            .string()
+            .describe('The ID of the long-running operation for creating the snapshot'),
+    },
+};
+// Delete Snapshot Tool
+export const deleteSnapshotTool = {
+    name: 'gcnv_snapshot_delete',
+    title: 'Delete Snapshot',
+    description: 'Deletes a snapshot of a 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 containing the snapshot'),
+        snapshotId: z.string().describe('The ID of the snapshot to delete'),
+    },
+    outputSchema: {
+        success: z.boolean().describe('Whether the deletion was successful'),
+        operationId: z.string().optional().describe('The ID of the long-running operation'),
+    },
+};
+// Get Snapshot Tool
+export const getSnapshotTool = {
+    name: 'gcnv_snapshot_get',
+    title: 'Get Snapshot',
+    description: 'Gets details of a specific snapshot',
+    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 containing the snapshot'),
+        snapshotId: z.string().describe('The ID of the snapshot to retrieve'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the snapshot'),
+        snapshotId: z.string().describe('The ID of the snapshot'),
+        volumeId: z.string().describe('The ID of the source volume'),
+        state: z.string().describe('The current state of the snapshot'),
+        createTime: z.date().describe('The timestamp when the snapshot was created'),
+        description: z.string().optional().describe('The description of the snapshot'),
+        labels: z.record(z.string()).optional().describe('Labels applied to the snapshot'),
+    },
+};
+// List Snapshots Tool
+export const listSnapshotsTool = {
+    name: 'gcnv_snapshot_list',
+    title: 'List Snapshots',
+    description: 'Lists all snapshots for a specified 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 list snapshots from'),
+        filter: z.string().optional().describe('Filter expression for filtering results'),
+        pageSize: z.number().optional().describe('The maximum number of snapshots to return'),
+        pageToken: z.string().optional().describe('Page token from a previous list request'),
+    },
+    outputSchema: {
+        snapshots: z
+            .array(z.object({
+            name: z.string().describe('The name of the snapshot'),
+            snapshotId: z.string().describe('The ID of the snapshot'),
+            volumeId: z.string().describe('The ID of the source volume'),
+            state: z.string().describe('The current state of the snapshot'),
+            createTime: z.date().describe('The timestamp when the snapshot was created'),
+            description: z.string().optional().describe('The description of the snapshot'),
+            labels: z.record(z.string()).optional().describe('Labels applied to the snapshot'),
+        }))
+            .describe('List of snapshots'),
+        nextPageToken: z.string().optional().describe('Token to retrieve the next page of results'),
+    },
+};
+// Revert Volume to Snapshot Tool
+export const revertVolumeToSnapshotTool = {
+    name: 'gcnv_snapshot_revert',
+    title: 'Revert Volume to Snapshot',
+    description: 'Reverts a volume to a previous snapshot state',
+    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 revert'),
+        snapshotId: z.string().describe('The ID of the snapshot to revert to'),
+    },
+    outputSchema: {
+        success: z.boolean().describe('Whether the revert operation was successful'),
+        operationId: z
+            .string()
+            .describe('The ID of the long-running operation for reverting the volume'),
+    },
+};
+// Update Snapshot Tool
+export const updateSnapshotTool = {
+    name: 'gcnv_snapshot_update',
+    title: 'Update Snapshot',
+    description: 'Updates the settings of a specific snapshot',
+    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 containing the snapshot'),
+        snapshotId: z.string().describe('The ID of the snapshot to update'),
+        description: z.string().optional().describe('New description of the snapshot'),
+        labels: z.record(z.string()).optional().describe('New labels to apply to the snapshot'),
+    },
+    outputSchema: {
+        name: z.string().describe('The name of the updated snapshot'),
+        operationId: z
+            .string()
+            .describe('The ID of the long-running operation for updating the snapshot'),
+    },
+};