Nutanix MCP-Server

Ein MCP-Server (Model Context Protocol), der Nutanix Prism Central- und Prism Element-APIs als Werkzeuge für KI-Assistenten wie GitHub Copilot, Claude und andere bereitstellt.

Funktionen

• Prism Central (v4 API) — VM-Verwaltung, Cluster-Inventar, Host-Verwaltung

• Prism Element (v2 API) — Direkter Cluster-Zugriff für Speicher, Festplatten, Warnmeldungen, Protection Domains

• As-Built-Berichte — Erstellung umfassender Markdown-Dokumentationen mit Excalidraw-Diagrammen auf Umgebungs-, Cluster- oder VM-Ebene

• API-Versions-Routing — Bevorzugt v4, greift bei Bedarf auf v3/v2 zurück

• Async — Nicht-blockierender HTTP-Client unter Verwendung von httpx

Related MCP server: nutanix-mcp

Verfügbare Werkzeuge

VM-Verwaltung (Prism Central v4)

Cluster-Verwaltung (Prism Central v4)

Netzwerk & Images (Prism Central v4)

Prism Element (v2 — direkter Cluster-Zugriff)

As-Built-Berichte

Berichte geben Markdown-Dokumentation und Excalidraw-JSON-Diagramme für die visuelle Topologie-Darstellung aus.

MCP-Ressourcen (URI-basiertes Browsing)

Der Server stellt Ressourcen über nutanix://-URIs bereit, was es LLMs ermöglicht, Entitäten ohne explizite Werkzeugaufrufe zu durchsuchen:

MCP-Prompts

Einrichtung

Voraussetzungen

• Python 3.10+

• Netzwerkzugriff auf Ihre Prism Central-Instanz (Port 9440)

• Nutanix-Anmeldedaten mit API-Zugriff

Installation

cd mcp/nutanix-mcp-server
pip install -e .

Oder mit Entwicklungsabhängigkeiten:

pip install -e ".[dev]"

Konfiguration

Kopieren Sie .env.example nach .env und tragen Sie Ihre Anmeldedaten ein:

cp .env.example .env

NUTANIX_HOST=your-prism-central.example.com
NUTANIX_PORT=9440
NUTANIX_USERNAME=your-username
NUTANIX_PASSWORD=your-password
NUTANIX_VERIFY_SSL=true
NUTANIX_TIMEOUT=30

Ausführung

nutanix-mcp

Oder direkt:

python -m nutanix_mcp

MCP-Client-Konfiguration

Dieser Server verwendet den stdio-Transport — er kommuniziert über stdin/stdout. Jeder Client konfiguriert einen Befehl zum Starten des Serverprozesses.

Tipp: Speichern Sie Anmeldedaten in Umgebungsvariablen oder einer .env-Datei, niemals in Konfigurationsdateien, die in die Versionsverwaltung eingecheckt werden.

Claude Code (CLI)

Fügen Sie den Server mit dem Befehl claude mcp add zu Ihrem Projekt hinzu:

claude mcp add nutanix -- python -m nutanix_mcp

Oder erstellen/bearbeiten Sie manuell die .mcp.json in Ihrem Projektstammverzeichnis:

{
  "mcpServers": {
    "nutanix": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "nutanix_mcp"],
      "cwd": "/path/to/mcp/nutanix-mcp-server",
      "env": {
        "NUTANIX_HOST": "your-prism-central.example.com",
        "NUTANIX_USERNAME": "your-username",
        "NUTANIX_PASSWORD": "your-password",
        "NUTANIX_VERIFY_SSL": "true"
      }
    }
  }
}

Für eine benutzerweite Verfügbarkeit (alle Projekte) fügen Sie es stattdessen zu ~/.claude.json hinzu.

Claude Desktop

Bearbeiten Sie die Konfigurationsdatei unter:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nutanix": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "nutanix_mcp"],
      "cwd": "/path/to/mcp/nutanix-mcp-server",
      "env": {
        "NUTANIX_HOST": "your-prism-central.example.com",
        "NUTANIX_USERNAME": "your-username",
        "NUTANIX_PASSWORD": "your-password",
        "NUTANIX_VERIFY_SSL": "true"
      }
    }
  }
}

Starten Sie Claude Desktop nach der Bearbeitung vollständig neu.

GitHub Copilot (VS Code)

Fügen Sie dies zu .vscode/mcp.json in Ihrem Arbeitsbereich hinzu:

{
  "servers": {
    "nutanix": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "nutanix_mcp"],
      "cwd": "${workspaceFolder}/mcp/nutanix-mcp-server",
      "env": {
        "NUTANIX_HOST": "your-prism-central.example.com",
        "NUTANIX_USERNAME": "your-username",
        "NUTANIX_PASSWORD": "your-password",
        "NUTANIX_VERIFY_SSL": "true"
      }
    }
  }
}

OpenCode (sst/opencode)

Fügen Sie dies zu opencode.json (oder opencode.jsonc) in Ihrem Projektstammverzeichnis hinzu:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nutanix": {
      "type": "local",
      "command": ["python", "-m", "nutanix_mcp"],
      "environment": {
        "NUTANIX_HOST": "your-prism-central.example.com",
        "NUTANIX_USERNAME": "your-username",
        "NUTANIX_PASSWORD": "your-password",
        "NUTANIX_VERIFY_SSL": "true"
      },
      "enabled": true
    }
  }
}

Hinweis: OpenCode verwendet "command" als Array und "environment" anstelle von "env".

Docker MCP Gateway

Das Docker MCP Gateway kann diesen Server innerhalb eines Containers proxen. Zwei Ansätze:

Option A: Direkt über Docker ausführen

Erstellen Sie ein Container-Image und referenzieren Sie es in Ihrer MCP-Client-Konfiguration:

FROM python:3.12-slim
WORKDIR /app
COPY mcp/nutanix-mcp-server/ .
RUN pip install --no-cache-dir -e .
CMD ["python", "-m", "nutanix_mcp"]

Dann in jeder MCP-Client-Konfiguration:

{
  "mcpServers": {
    "nutanix": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "NUTANIX_HOST=your-prism-central.example.com",
        "-e", "NUTANIX_USERNAME=your-username",
        "-e", "NUTANIX_PASSWORD=your-password",
        "-e", "NUTANIX_VERIFY_SSL=true",
        "nutanix-mcp-server"
      ]
    }
  }
}

Option B: Beim Docker MCP Gateway registrieren

Wenn Sie Docker Desktop mit dem MCP Toolkit verwenden:

docker mcp gateway run

Konfigurieren Sie das Gateway-Profil so, dass der Nutanix-Server enthalten ist. Das Gateway stellt dann alle registrierten MCP-Server als einen einzigen, vereinheitlichten Endpunkt bereit.

Verweisen Sie in Ihrem KI-Client auf das Gateway:

{
  "mcpServers": {
    "MCP_DOCKER": {
      "command": "docker",
      "args": ["mcp", "gateway", "run"]
    }
  }
}

Das Gateway übernimmt das Routing, das Lebenszyklusmanagement und die Isolierung der Anmeldedaten.

API-Versionsstrategie

Prism Element-Hosts entdecken

Verwenden Sie list_clusters, um Cluster-UUIDs zu finden, und dann list_hosts, um CVM-IPs zu finden. Diese CVM-IPs können als pe_host in den Prism Element-Werkzeugen verwendet werden.

Entwicklung

# Lint
ruff check src/

# Type check
mypy src/

# Test
pytest

Referenzen

• Nutanix v4 API-Dokumentation

• Nutanix Developer Portal

• Prism Central v3 API

• Prism Element v2 API

• MCP-Protokollspezifikation