README.md
Interact with your Nasuni environment through Claude AI integration
Nasuni Management MCP Server (Local)
A comprehensive Model Context Protocol (MCP) server that provides tools for interacting with your Nasuni environment (Nasuni Management Center (NMC) and Portal) through Claude AI integration. Using this MCP server, you can get granular details about your Nasuni environment, monitor the health of your appliances, summarize notifications, and generate custom reports.
Note: Nasuni Management MCP Server is Claude-specific using Anthropic's MCP framework.
Features
Infrastructure Management
- Filer(Edge) Management: List, monitor, and manage Edge Appliances
- Volume Operations: Comprehensive volume detail reporting
- Share Administration: SMB/CIFS Share management
- Health Monitoring: Real-time system health and performance monitoring
Analytics & Reporting
- Performance Metrics: Detailed system performance analytics
- Usage Statistics: Comprehensive usage reporting and analysis
- Notification Management: Centralized alert and notification handling
Support Statement
- Nasuni Support is limited to the underlying APIs used by the MCP Server.
- Nasuni API bugs or feature requests should be communicated to Nasuni Customer Success.
- GitHub project to-do's, bugs, and feature requests should be submitted as “Issues” in GitHub under its repositories.
Prerequisites
Python Requirements
- Python: Version 3.11+ or later is required
- Recommendation: Install the latest stable Python version for best performance and security
Checking Your Python Version
# Check version (should be 3.11+)
python --version
# or
python3 --version
Installing the Latest Python Version
Always install the latest stable Python version from the official Python website.
macOS (using Homebrew):
# If Python is installed but running a version older than 3.11
brew upgrade python
# Install latest Python (recommended)
brew install python
# Or install latest Python 3
brew install python@3
Windows:
- Visit python.org/downloads
- Download the latest Python version
- Run the installer and make sure to check "Add Python to PATH"
Using pyenv (Cross-platform - Recommended for Developers):
# Install pyenv first, then:
pyenv install --list | grep "3\." | tail -5 # See latest versions
pyenv install 3.13.1 # Replace with latest version number
pyenv global 3.13.1 # Set as default
pyenv versions # Verify installation
Linux (Ubuntu/Debian):
# Add deadsnakes PPA for latest Python versions
sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
# Install latest Python (check python.org for current version number)
sudo apt install python3.13 python3.13-pip python3.13-venv python3.13-dev
# Or use your distribution's latest available version
sudo apt install python3 python3-pip python3-venv
# For other Linux distributions:
# CentOS/RHEL/Fedora:
sudo dnf install python3 python3-pip python3-venv
# Arch Linux:
sudo pacman -S python python-pip
Claude AI Integration Requirements
- Claude AI Compatibility: This server is designed exclusively for Claude AI and uses Anthropic's Model Context Protocol (MCP) framework
- Claude Desktop Client: Required for local deployment - the MCP server integrates with Claude through the desktop application
- Download: Get Claude Desktop Client
- Important: When running locally, MCP server tools are only accessible through the Claude Desktop Client, not through Claude's web interface
NMC API Requirements
-NMC Version: Recommended NMC Version 24.1.x or later
- NMC Credentials: Accessing the NMC API requires a user who is a member of an NMC group that has the "Enable NMC API Access" permission enabled
- API Permissions: Along with 'Enable NMC API Access', the API users must also have the corresponding NMC permission for each action they perform. For a granular permission set, refer to the Available Tools section.
- Account Types: Both native and domain accounts are supported for NMC API authentication (SSO accounts are not supported via the NMC API)
Installation
There are two options to install and configure the Nasuni Management MCP Server:
1. Automated Setup (Recommended)
2. Manual Setup
Option 1: Automated Setup (Recommended)
The automated installer handles all setup steps including downloading the code, creating
Tools (4)
list_filersList and monitor Edge Appliances in the Nasuni environment.get_volume_detailsRetrieve comprehensive volume detail reporting.manage_sharesPerform administrative tasks for SMB/CIFS shares.get_system_healthMonitor real-time system health and performance metrics.Environment Variables
NMC_URLrequiredThe URL of the Nasuni Management CenterNMC_USERNAMErequiredUsername for NMC API accessNMC_PASSWORDrequiredPassword for NMC API accessConfiguration
claude_desktop_config.json
{"mcpServers": {"nasuni-management": {"command": "python", "args": ["/path/to/nasuni-management-mcp-server/main.py"], "env": {"NMC_URL": "https://your-nmc-url", "NMC_USERNAME": "your-username", "NMC_PASSWORD": "your-password"}}}}Try it
→What is the current health status of my Edge Appliances?
→Generate a summary report of all SMB shares currently configured.
→Can you provide the performance metrics for the primary storage volume?
→Summarize the latest system notifications from the Nasuni Management Center.