Skip to main content
Glama
sachdev27

Dell Isilon (PowerScale) MCP Server

by sachdev27

Isilon MCP Server

PyPI version Python 3.10+ Tests codecov License: MIT

A professional-grade Model Context Protocol (MCP) server for Dell PowerScale (Isilon) OneFS API integration. This server enables AI assistants like Claude to interact with PowerScale storage clusters through a comprehensive set of tools generated from the OneFS 9.7 REST API specification.

Features

  • šŸš€ Complete API Coverage: 2,434 operations across 46 categories

  • šŸ” Secure Authentication: Basic Auth with TLS support

  • šŸ“¦ Dynamic Tool Generation: Auto-generates MCP tools from OpenAPI spec

  • šŸ”„ Multiple Transports: stdio (Claude Desktop) and HTTP/SSE (n8n)

  • šŸ“ Comprehensive Logging: Structured JSON and colored console output

  • ⚔ Async/Await: Built on httpx for high-performance async operations

  • šŸ›”ļø Credential-Free Mode: Explore available tools without credentials

Supported API Categories

Category

Operations

Description

Auth

373

Authentication, users, groups, roles, providers

Protocols

351

SMB, NFS, HDFS, S3, HTTP, FTP, Swift

Sync

185

SyncIQ replication policies, reports, jobs

Cluster

167

Cluster management, nodes, configuration

Network

153

Networking, subnets, pools, interfaces

Datamover

151

Data migration, accounts, policies

Cloud

136

CloudPools, tiering, accounts

Snapshot

117

Snapshot schedules, aliases, locks

Upgrade

85

Cluster upgrade management

Event

83

Event channels, alerts, settings

Quota

78

SmartQuotas management

Job

72

Job engine, policies, reports

...

...

And 34 more categories!

Quick Start

Prerequisites

  • Python 3.10 or higher

  • Access to a Dell PowerScale cluster with REST API enabled

  • API credentials with appropriate permissions

Installation

# Install the package pip install isilon-mcp-server # Or install with HTTP server support for n8n pip install "isilon-mcp-server[http]"

From Source

# Clone the repository git clone https://github.com/sachdev27/isilon-mcp-server.git cd isilon-mcp-server # Create virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install the package pip install -e . # Or install with HTTP server support for n8n pip install -e ".[http]"

Configuration

  1. Copy the example environment file:

cp .env.example .env
  1. Edit .env with your PowerScale credentials:

ISILON_HOST=your-powerscale-host ISILON_USERNAME=admin ISILON_PASSWORD=your-secure-password ISILON_PORT=8080 ISILON_TLS_VERIFY=true

Running the Server

stdio Transport (for Claude Desktop)

# Using the CLI isilon-mcp # Or using Python module python -m isilon_mcp.main

HTTP/SSE Transport (for n8n or web clients)

# Start HTTP server python -m isilon_mcp.http_server # With custom host/port python -m isilon_mcp.http_server --host 0.0.0.0 --port 8000

Claude Desktop Integration

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{ "mcpServers": { "isilon": { "command": "/path/to/venv/bin/python", "args": ["-m", "isilon_mcp.main"], "cwd": "/path/to/isilon-mcp-server", "env": { "ISILON_HOST": "your-powerscale-host", "ISILON_USERNAME": "admin", "ISILON_PASSWORD": "your-password" } } } }

n8n Integration

  1. Start the HTTP server:

python -m isilon_mcp.http_server --host 0.0.0.0 --port 8000
  1. In n8n, add an MCP Client node pointing to:

http://localhost:8000/sse

Example Usage

Once connected, you can ask Claude to:

  • "List all SMB shares on the cluster"

  • "Show me the cluster health status"

  • "Create a new NFS export for /ifs/data/project1"

  • "Get all snapshots older than 30 days"

  • "Show active SyncIQ policies"

  • "List users in the local provider"

Project Structure

isilon-mcp-server/ ā”œā”€ā”€ isilon_mcp/ │ ā”œā”€ā”€ __init__.py # Package exports │ ā”œā”€ā”€ api_client.py # Async HTTP client with Basic Auth │ ā”œā”€ā”€ config.py # Pydantic configuration models │ ā”œā”€ā”€ exceptions.py # Exception hierarchy │ ā”œā”€ā”€ http_server.py # HTTP/SSE transport for n8n │ ā”œā”€ā”€ logging_config.py # Structured logging │ ā”œā”€ā”€ main.py # CLI entry point (stdio) │ ā”œā”€ā”€ server.py # Core MCP server │ └── tool_generator.py # OpenAPI to MCP tool generator ā”œā”€ā”€ powerscale_9.7_comprehensive_openapi.json # Full API spec ā”œā”€ā”€ pyproject.toml # Package configuration ā”œā”€ā”€ requirements-mcp.txt # Dependencies ā”œā”€ā”€ .env.example # Configuration template └── README.md # This file

Development

Running Tests

# Install dev dependencies pip install -e ".[dev]" # Run tests pytest # With coverage pytest --cov=isilon_mcp --cov-report=html

Code Quality

# Format code black isilon_mcp/ isort isilon_mcp/ # Lint ruff check isilon_mcp/ # Type checking mypy isilon_mcp/

API Reference

Tool Naming Convention

Tools are named using the pattern:

{category}_{operationId}

Examples:

  • auth_list_providers - List authentication providers

  • protocols_list_smb_shares - List SMB shares

  • snapshot_create_snapshot - Create a new snapshot

  • cluster_get_cluster_config - Get cluster configuration

Authentication

The server uses HTTP Basic Authentication with your PowerScale credentials. All requests are made over HTTPS by default.

Error Handling

The server provides detailed error messages for:

  • Authentication failures

  • Connection errors

  • Rate limiting

  • API validation errors

Security Considerations

  1. Never commit - They contain sensitive credentials

  2. Use TLS verification - Set ISILON_TLS_VERIFY=true in production

  3. Principle of least privilege - Use API users with minimal required permissions

  4. Read-only mode - Set READ_ONLY_MODE=true for monitoring-only access

Troubleshooting

Connection Issues

# Test connection manually curl -k -u username:password https://your-host:8080/platform/18/cluster/config

Certificate Errors

If using self-signed certificates:

ISILON_TLS_VERIFY=false # Only for testing!

Debug Mode

Enable detailed logging:

LOG_LEVEL=DEBUG DEBUG_HTTP=true

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please read our contributing guidelines and submit pull requests.

Acknowledgments

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sachdev27/dell-isilon-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server