Merge branch 'release-v2.7.0' of https://bitbucket.ngage.netapp.com/scm/sie-bb/netapp-dataops-toolkit into feature/code-refactoring/logger

Author: netapp-shreyamenneni

mcp_servers.md

@@ -16,6 +16,7 @@ The [NetApp DataOps Toolkit MCP Server for ONTAP](netapp_dataops_traditional/doc
 - **List Snapshots**: Retrieve a list of all snapshots for a specific volume.
 - **Create SnapMirror Relationship**: Set up SnapMirror relationships for efficient data replication.
 - **List SnapMirror Relationships**: Retrieve a list of all SnapMirror relationships on the storage system.
+- **Create FlexCache Volume**: Create FlexCache volumes for efficient data access and caching.
 
 ## NetApp DataOps Toolkit for Kubernetes MCP Server
 
@@ -40,3 +41,4 @@ This MCP Server provides the following tools for managing JupyterLab workspaces
 - **ListVolumes**: List all volumes.
 - **CreateVolumeSnapshot**: Create a snapshot of a volume.
 - **ListVolumeSnapshots**: List all snapshots of volumes.
+- **CreateFlexCache**: Create a FlexCache volume.

netapp_dataops_k8s/docs/mcp_server_k8s.md

@@ -26,6 +26,7 @@ The MCP server provides the following tools for managing JupyterLab workspaces a
 - **ListVolumes**: List all volumes.
 - **CreateVolumeSnapshot**: Create a snapshot of a volume.
 - **ListVolumeSnapshots**: List all snapshots of volumes.
+- **CreateFlexCache**: Create a new FlexCache volume.
 
 ## Quick Start
 

netapp_dataops_k8s/netapp_dataops/netapp_dataops_k8s_mcp.py

@@ -17,7 +17,8 @@
     clone_volume,
     list_volumes,
     create_volume_snapshot,
-    list_volume_snapshots
+    list_volume_snapshots,
+    create_flexcache
 )
 
 #Sets up logging
@@ -458,6 +459,62 @@ def list_volume_snapshots_tool(
         logger.error(f"Error listing volume snapshots: {e}")
         raise
 
+@mcp.tool(name="CreateFlexCache")
+def create_flexcache_tool(
+    source_vol: str,
+    source_svm: str,
+    flexcache_vol: str,
+    flexcache_size: str,
+    backend_name: str,
+    junction: Optional[str] = None,
+    namespace: str = "default",
+    trident_namespace: str = "trident",
+    print_output: bool = False
+) -> str:
+    """
+    Create a FlexCache volume in ONTAP and a corresponding PersistentVolume (PV) and PersistentVolumeClaim (PVC) in Kubernetes.
+
+    This function creates a FlexCache volume in ONTAP and then creates a PV and PVC representing the FlexCache in a specified Kubernetes namespace.
+
+    Parameters:
+    - source_vol (str): The name of the source volume in the source SVM that will be cached by the FlexCache volume.
+    - source_svm (str): The name of the source Storage Virtual Machine (SVM) that contains the origin volume to be cached.
+    - flexcache_vol (str): The name of the FlexCache volume to be created.
+    - flexcache_size (str): The size of the FlexCache volume to be created. The size must be specified in a format such as '1024Mi', '100Gi', '10Ti', etc. Note: The size must be at least 50Gi.
+    - backend_name (str): The name of the tridentbackendconfig.
+    - junction (str, optional): The junction path for the FlexCache volume. Default is None.
+    - namespace (str, optional): Kubernetes namespace to create the new PersistentVolumeClaim (PVC) in. Default is "default".
+    - trident_namespace (str, optional): Kubernetes namespace where Trident is installed. Default is "trident".
+    - print_output (bool, optional): Whether to print output messages. Default is False.
+
+    Returns:
+    - str: A message indicating the successful creation of the FlexCache volume and the associated PVC.
+
+    Raises:
+    - InvalidConfigError: If the Kubernetes configuration is invalid.
+    - APIConnectionError: If there is an error connecting to the Kubernetes API.
+    - InvalidVolumeParameterError: If the volume parameters are invalid.
+    - NetAppRestError: If there is an error with the NetApp REST API.
+    - ConnectionTypeError: If the connection type is invalid.
+    """
+    try:
+        result = create_flexcache(
+            source_vol=source_vol,
+            source_svm=source_svm,
+            flexcache_vol=flexcache_vol,
+            flexcache_size=flexcache_size,
+            backend_name=backend_name,
+            junction=junction,
+            namespace=namespace,
+            trident_namespace=trident_namespace,
+            print_output=print_output
+        )
+
+        return f"FlexCache volume '{result['ontap_flexcache']}' and PVC '{result['k8s_pvc']}' created successfully."
+    except Exception as e:
+        print(f"Error creating FlexCache volume: {e}")
+        raise
+
 def main():
     try:
         # Starts the MCP server using stdio transport for local operation

netapp_dataops_traditional/docs/gcnv_mcp_server_readme.md

@@ -0,0 +1,155 @@
+# NetApp DataOps Toolkit MCP Server for Google Cloud NetApp Volumes (GCNV)
+
+The NetApp DataOps Toolkit MCP Server for Google Cloud NetApp Volumes (GCNV) is an open-source server component written in Python that provides access to Traditional DataOps Toolkit capabilities through the Model Context Protocol (MCP). The server provides a set of tools for managing NetApp volumes in Google Cloud, including volume creation, cloning, snapshot management, and replication relationships.
+
+> [!NOTE]  
+> This MCP server uses the stdio transport, as shown in the [MCP Server Quickstart](https://modelcontextprotocol.io/quickstart/server), making it a "local MCP server".
+
+## Tools
+
+- **Create Volume**: Rapidly provision new NetApp volumes in Google Cloud with customizable configurations including protocols, security settings, and backup policies.
+- **Clone Volume**: Create near-instantaneous, space-efficient clones of existing volumes from snapshots using NetApp technology.
+- **List Volumes**: Retrieve a list of all existing data volumes in a specified project and location.
+- **Create Snapshot**: Create space-efficient, read-only copies of data volumes for versioning and traceability.
+- **List Snapshots**: Retrieve a list of all snapshots for a specific volume.
+- **Create Replication**: Set up replication relationships for efficient data replication and disaster recovery between volumes.
+
+## Prerequisites
+
+- Python >= 3.9
+- [`uv`](https://docs.astral.sh/uv/) or [`pip`](https://pypi.org/project/pip/)
+- [Google Cloud SDK](https://cloud.google.com/sdk/docs/install) installed and authenticated
+- NetApp API enabled on GCP project
+
+## Usage Instructions
+
+### Run with `uv` (recommended)
+
+To run the MCP server using `uv`, run the following command. You do not need to install the NetApp DataOps Toolkit package before running this command.
+
+```bash
+uvx --from 'netapp-dataops-traditional[gcp]' netapp_dataops_gcnv_mcp.py
+```
+
+### Install with `pip` and run from PATH
+
+To install the NetApp DataOps Toolkit for Traditional Environments, run the following command.
+
+```bash
+python3 -m pip install 'netapp-dataops-traditional[gcp]'
+```
+
+After installation, the `netapp_dataops_gcnv_mcp.py` command will be available in your PATH for direct usage.
+
+## Usage
+
+### Google Cloud Authentication
+
+Before the MCP server can be used to perform GCNV operations, you must authenticate with Google Cloud and ensure proper setup:
+
+1. **Install Google Cloud SDK**: Follow the [installation guide](https://cloud.google.com/sdk/docs/install)
+
+2. **Authenticate with Google Cloud**:
+   ```bash
+   gcloud auth login
+   ```
+
+3. **Set your default project**:
+   ```bash
+   gcloud config set project YOUR_PROJECT_ID
+   ```
+
+4. **Authenticate application default credentials**:
+   ```bash
+   gcloud auth application-default login
+   ```
+
+4. **Enable the NetApp API**:
+   ```bash
+   gcloud services enable netapp.googleapis.com
+   ```
+
+5. **Verify API is enabled**:
+   ```bash
+   gcloud services list --enabled --filter="name:netapp.googleapis.com"
+   ```
+
+### Example JSON Config
+
+To use the MCP server with an MCP client, you need to configure the client to use the server. For many clients (such as [VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers), [Claude Desktop](https://modelcontextprotocol.io/quickstart/user), and [AnythingLLM](https://docs.anythingllm.com/mcp-compatibility/overview)), this requires editing a config file that is in JSON format. Below is an example. Refer to the documentation for your MCP client for specific formatting details.
+
+```json
+{
+  "mcpServers": {
+    "netapp_dataops_gcnv_mcp": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--from",
+        "'netapp-dataops-traditional[gcp]'",
+        "netapp_dataops_gcnv_mcp.py"
+      ]
+    }
+  }
+}
+```
+
+### Alternative: Using `pip` installation
+
+If you've installed the package with `pip`, you can use:
+
+```json
+{
+  "mcpServers": {
+    "netapp_dataops_gcnv_mcp": {
+      "type": "stdio",
+      "command": "netapp_dataops_gcnv_mcp.py"
+    }
+  }
+}
+```
+
+### Alternative: Direct Python execution
+
+For development or testing purposes:
+
+```json
+{
+  "mcpServers": {
+    "netapp_dataops_gcnv_mcp": {
+      "type": "stdio",
+      "command": "python",
+      "args": [
+        "/path/to/netapp_dataops_gcnv_mcp.py"
+      ]
+    }
+  }
+}
+```
+
+## Environment Variables
+
+You can optionally set these environment variables:
+
+- `GOOGLE_APPLICATION_CREDENTIALS`: Path to service account key file (if not using default credentials)
+- `GOOGLE_CLOUD_PROJECT`: Default project ID to use
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Authentication Failed**:
+   ```bash
+   gcloud auth login
+   ```
+
+2. **API Not Enabled**:
+   ```bash
+   gcloud services enable netapp.googleapis.com --project=YOUR_PROJECT_ID
+   ```
+
+3. **Module Not Found**: Ensure the package is properly installed or use the full path
+
+## Support
+
+Report any issues via GitHub: https://github.com/NetApp/netapp-dataops-toolkit/issues.