Vast Storage MCP Server

An MCP (Model Context Protocol) server that enables LLMs to interact with VAST Data storage APIs. This server exposes VAST Data management endpoints as tools for comprehensive storage infrastructure management and automation.

This project implements a Model Context Protocol (MCP) server for the VAST Data storage API, allowing LLMs like GitHub Copilot and Claude to interact with VAST storage infrastructure through natural language commands.

- TypeScriptfor type-safe implementation
- @modelcontextprotocol/sdkfor MCP protocol handling
- Axiosfor HTTP/REST API communication
- Winstonfor logging (to stderr to avoid protocol corruption)
- OpenAPI 3.0specification for automatic tool generation

- Views(4 tools): NFS, SMB, and S3 file system views
- Quotas(4 tools): Directory and user quotas with hard/soft limits

- VIP Pools(4 tools): Virtual IP pool management
- Clusters(2 tools): Cluster monitoring and status
- Nodes(2 tools): Cluster node information and health

- Protected Paths(3 tools): Data protection and replication setup
- Snapshots(4 tools): Snapshot creation and lifecycle management

- Users(4 tools): User account management
- Tenants(4 tools): Multi-tenancy configuration

- Alarms(4 tools): Alarm monitoring, acknowledgement, and management
- Events(2 tools): Event log querying and filtering
- Analytics(2 tools): Performance and capacity analytics with time-series data

- Node.js 18+ installed
- VSCode with GitHub Copilot or Claude Desktop
- VAST Data cluster with API access
- VAST API credentials (username and password)

Option A: Interactive Setup (Recommended)

cp .env.example .env # Edit .env with your VAST cluster details

VAST_API_BASE_URL=https://your-vast-cluster.example.com VAST_API_USERNAME=your-username VAST_API_PASSWORD=your-password VAST_SSL_VERIFY=false LOG_LEVEL=info

-

Open VSCode Settings:Cmd+Shift+P→ "Preferences: Open User Settings (JSON)"

Add this configuration to yoursettings.json:

{ "github.copilot.chat.mcp.servers": { "vast": { "command": "node", "args": ["/path/to/vast_MCP/dist/main.js"], "env": { "VAST_API_BASE_URL": "https://your-vast-cluster.example.com", "VAST_API_USERNAME": "your-username", "VAST_API_PASSWORD": "your-password", "LOG_LEVEL": "info" } } } }

- Reload VS Code:Cmd+Shift+P→ "Developer: Reload Window"
-

Locate your Claude Desktop configuration file:

- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json
- Linux:~/.config/Claude/claude_desktop_config.json

Add this configuration toclaude_desktop_config.json:

{ "mcpServers": { "vast": { "command": "node", "args": ["/path/to/vast_MCP/dist/main.js"], "env": { "VAST_API_BASE_URL": "https://your-vast-cluster.example.com", "VAST_API_USERNAME": "your-username", "VAST_API_PASSWORD": "your-password", "LOG_LEVEL": "info" } } } }

The MCP server automatically generates tools from the VAST API specification:

- viewsGetAll- List all file system views
- viewsGetById- Get specific view details
- viewsCreate- Create new file system views (NFS, SMB, S3)
- viewsUpdate- Update view configuration
- viewsDelete- Delete a view

- quotasGetAll- List all quotas
- quotasGetById- Get specific quota details
- quotasCreate- Create new quotas with hard/soft limits
- quotasUpdate- Update quota configuration
- quotasDelete- Delete a quota

- vippoolsGetAll- List all VIP pools
- vippoolsGetById- Get specific VIP pool details
- vippoolsCreate- Create new VIP pools
- vippoolsUpdate- Update VIP pool configuration
- vippoolsDelete- Delete a VIP pool

- clustersGetAll- List all clusters
- clustersGetById- Get cluster details
- cnodesGetAll- List all cluster nodes
- cnodesGetById- Get node details and status

- protectedPathsGetAll- List all protected paths
- protectedPathsGetById- Get protected path details
- protectedPathsCreate- Create new protected paths
- protectedPathsDelete- Delete protected path

- snapshotsGetAll- List all snapshots
- snapshotsGetById- Get snapshot details
- snapshotsCreate- Create new snapshots
- snapshotsDelete- Delete a snapshot

- usersGetAll- List all users
- usersGetById- Get user details
- usersCreate- Create new users
- usersUpdate- Update user configuration
- usersDelete- Delete a user

- tenantsGetAll- List all tenants
- tenantsGetById- Get tenant details
- tenantsCreate- Create new tenants
- tenantsUpdate- Update tenant configuration
- tenantsDelete- Delete a tenant

- alarmsGetAll- List all alarms with filtering by severity, state, and category
- alarmsGetById- Get specific alarm details
- alarmsUpdate- Update alarm state (acknowledge or clear alarms)
- alarmsDelete- Delete an alarm

- eventsGetAll- List all events with filtering by type, severity, time range, and category
- eventsGetById- Get specific event details

- analyticsGetAll- List analytics metrics with filtering by metric type, time range, and interval
- analyticsGetById- Get specific analytics data by ID

## Advanced Configuration ### Using with Multiple VAST Clusters Configure multiple server instances in your LLM client: 

To use a custom or extended VAST API specification:

- VAST Data API Documentation
- Model Context Protocol
- OpenAPI Specification 3.0
- Hyperfabric MCP Reference

A remote MCP server deployable on Cloudflare Workers with OAuth login support, using Cloudflare KV for data storage.