Zadara Storage MCP Server

An MCP (Model Context Protocol) server that provides access to Zadara Storage APIs, including both VPSA Storage Array and Object Storage endpoints.

Features

VPSA Storage Array Support

• List, create, get, and delete volumes
• List storage pools
• List connected servers
• Create and list snapshots
• Get performance metrics
• List controllers
• Custom API requests for any VPSA endpoint

Object Storage Support

• List, create, and delete buckets
• List objects in buckets
• Get and set bucket policies
• Get and set bucket versioning
• Custom API requests for any Object Storage endpoint

Installation

1. Clone or download this repository
2. Install dependencies:

pip install -r requirements.txt

Configuration

The server requires environment variables for authentication:

VPSA Storage Array

export ZADARA_VPSA_URL="https://your-vpsa-hostname.com"
export ZADARA_VPSA_API_KEY="your-api-key"

Object Storage

export ZADARA_OBJECT_STORAGE_URL="https://your-object-storage-url.com"
export ZADARA_OBJECT_ACCESS_KEY="your-access-key"
export ZADARA_OBJECT_SECRET_KEY="your-secret-key"

Running the Server

Standalone Mode

python server.py

With Claude Desktop

Add this configuration to your Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "zadara-storage": {
      "command": "python",
      "args": ["/path/to/zadara-mcp-server/server.py"],
      "env": {
        "ZADARA_VPSA_URL": "https://your-vpsa-hostname.com",
        "ZADARA_VPSA_API_KEY": "your-api-key",
        "ZADARA_OBJECT_STORAGE_URL": "https://your-object-storage-url.com",
        "ZADARA_OBJECT_ACCESS_KEY": "your-access-key",
        "ZADARA_OBJECT_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Available Tools

VPSA Storage Array Tools

vpsa_list_volumes

List all volumes in the VPSA storage array.

Parameters:

• limit (optional): Maximum number of volumes to return
• offset (optional): Offset for pagination

vpsa_create_volume

Create a new volume in the VPSA storage array.

Parameters:

• name (required): Name of the volume
• capacity (required): Capacity in GB
• pool (required): Storage pool name or ID
• block_size (optional): Block size in KB

vpsa_get_volume

Get details of a specific volume.

Parameters:

• volume_id (required): Volume ID or name

vpsa_delete_volume

Delete a volume from the VPSA storage array.

Parameters:

• volume_id (required): Volume ID or name to delete

vpsa_list_pools

List all storage pools in the VPSA.

vpsa_list_servers

List all servers connected to the VPSA.

vpsa_create_snapshot

Create a snapshot of a volume.

Parameters:

• volume_id (required): Volume ID to snapshot
• snapshot_name (required): Name for the snapshot

vpsa_list_snapshots

List all snapshots.

Parameters:

• volume_id (optional): Filter by volume ID

vpsa_get_performance

Get performance metrics for the VPSA.

Parameters:

• interval (optional): Time interval (e.g., '1h', '24h', '7d')

vpsa_list_controllers

List all controllers in the VPSA.

vpsa_custom_request

Make a custom API request to VPSA Storage Array.

Parameters:

• method (required): HTTP method (GET, POST, PUT, DELETE)
• endpoint (required): API endpoint path (without /api/ prefix)
• data (optional): Request body data
• params (optional): Query parameters

Object Storage Tools

object_list_buckets

List all buckets in object storage.

object_create_bucket

Create a new bucket in object storage.

Parameters:

• bucket_name (required): Name of the bucket to create
• region (optional): Region for the bucket

object_delete_bucket

Delete a bucket from object storage.

Parameters:

• bucket_name (required): Name of the bucket to delete

object_list_objects

List objects in a bucket.

Parameters:

• bucket_name (required): Name of the bucket
• prefix (optional): Prefix filter for object keys
• max_keys (optional): Maximum number of keys to return

object_get_bucket_policy

Get the policy of a bucket.

Parameters:

• bucket_name (required): Name of the bucket

object_set_bucket_policy

Set the policy of a bucket.

Parameters:

• bucket_name (required): Name of the bucket
• policy (required): Bucket policy JSON

object_get_bucket_versioning

Get versioning configuration of a bucket.

Parameters:

• bucket_name (required): Name of the bucket

object_set_bucket_versioning

Set versioning configuration of a bucket.

Parameters:

• bucket_name (required): Name of the bucket
• status (required): Versioning status (Enabled or Suspended)

object_custom_request

Make a custom API request to Object Storage.

Parameters:

• method (required): HTTP method (GET, POST, PUT, DELETE)
• endpoint (required): API endpoint path
• data (optional): Request body data
• params (optional): Query parameters

Usage Examples

Once configured with Claude Desktop, you can interact with the server using natural language:

"List all volumes in my VPSA storage"
"Create a new volume named 'backup-vol' with 100GB capacity in pool 'pool-1'"
"Show me all buckets in my object storage"
"Create a snapshot of volume 'vol-123' named 'snapshot-2024'"
"List all objects in bucket 'my-data-bucket'"

API Documentation

For detailed API documentation, refer to:

• VPSA Storage Array: https://api-doc.zadarastorage.com/?urls.primaryName=VPSA%20Storage%20Array%20-%20VPSA%20Flash%20Array
• Object Storage: https://api-doc.zadarastorage.com/?urls.primaryName=Object%20Storage

Authentication

VPSA Storage Array

The VPSA API uses API key authentication via the X-Access-Key header.

Object Storage

The Object Storage API uses AWS S3-compatible authentication. You can use:

• Access Key and Secret Key for AWS Signature authentication
• Or configure your endpoint URL to use pre-signed URLs

Error Handling

The server will return error messages in the following cases:

• Missing or invalid credentials
• Invalid API endpoints
• Network connectivity issues
• API rate limiting
• Invalid parameters

Development

To extend this server with additional tools:

1. Add the tool definition to the list_tools() function
2. Implement the tool handler in the call_tool() function
3. Use the ZadaraClient class methods to make API requests

Security Notes

• Never commit your API keys or credentials to version control
• Use environment variables for all sensitive configuration
• Ensure your VPSA and Object Storage endpoints use HTTPS
• Regularly rotate your API keys
• Follow the principle of least privilege when creating API keys

Troubleshooting

Connection Issues

• Verify your VPSA_URL and OBJECT_STORAGE_URL are correct
• Check network connectivity to your Zadara endpoints
• Ensure firewall rules allow outbound HTTPS connections

Authentication Errors

• Verify your API keys are correct
• Check that your API keys have the necessary permissions
• Ensure keys haven't expired

Tool Not Working

• Check the server logs for detailed error messages
• Verify the tool parameters match the expected schema
• Test the API endpoint directly using curl or Postman

License

This MCP server is provided as-is for use with Zadara Storage systems.

Support

For Zadara Storage API support, refer to the official Zadara documentation or contact Zadara support.

For MCP server issues, please check the MCP documentation at https://modelcontextprotocol.io/