Servidor Nutanix MCP

Un servidor MCP (Model Context Protocol) que expone las API de Nutanix Prism Central y Prism Element como herramientas para asistentes de IA como GitHub Copilot, Claude y otros.

Características

• Prism Central (API v4) — Gestión de máquinas virtuales, inventario de clústeres, gestión de hosts

• Prism Element (API v2) — Acceso directo al clúster para almacenamiento, discos, alertas, dominios de protección

• Informes de estado actual (As-Built) — Generación de documentación Markdown completa con diagramas de Excalidraw a nivel de entorno, clúster o máquina virtual

• Enrutamiento de versiones de API — Prefiere v4, recurre a v3/v2 cuando es necesario

• Asíncrono — Cliente HTTP no bloqueante usando httpx

Related MCP server: nutanix-mcp

Herramientas disponibles

Gestión de máquinas virtuales (Prism Central v4)

Gestión de clústeres (Prism Central v4)

Redes e imágenes (Prism Central v4)

Prism Element (v2 — acceso directo al clúster)

Informes de estado actual (As-Built)

Los informes generan documentación en Markdown y diagramas JSON de Excalidraw para la representación visual de la topología.

Recursos MCP (navegación basada en URI)

El servidor expone recursos a través de URIs nutanix://, permitiendo a los LLMs navegar por las entidades sin llamadas explícitas a herramientas:

Prompts MCP

Configuración

Requisitos previos

• Python 3.10+

• Acceso de red a su instancia de Prism Central (puerto 9440)

• Credenciales de Nutanix con acceso a la API

Instalación

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

O con dependencias de desarrollo:

pip install -e ".[dev]"

Configuración

Copie .env.example a .env y rellene sus credenciales:

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

Ejecución

nutanix-mcp

O directamente:

python -m nutanix_mcp

Configuración del cliente MCP

Este servidor utiliza transporte stdio: se comunica a través de stdin/stdout. Cada cliente configura un comando para iniciar el proceso del servidor.

Consejo: Almacene las credenciales en variables de entorno o en un archivo .env, nunca en archivos de configuración confirmados en el control de versiones.

Claude Code (CLI)

Añada el servidor a su proyecto con el comando claude mcp add:

claude mcp add nutanix -- python -m nutanix_mcp

O cree/edite manualmente .mcp.json en la raíz de su proyecto:

{
  "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"
      }
    }
  }
}

Para disponibilidad a nivel de usuario (todos los proyectos), añádalo a ~/.claude.json en su lugar.

Claude Desktop

Edite el archivo de configuración en:

• 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"
      }
    }
  }
}

Reinicie Claude Desktop completamente después de editar.

GitHub Copilot (VS Code)

Añada a .vscode/mcp.json en su espacio de trabajo:

{
  "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)

Añada a opencode.json (o opencode.jsonc) en la raíz de su proyecto:

{
  "$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
    }
  }
}

Nota: OpenCode utiliza "command" como una matriz y "environment" en lugar de "env".

Docker MCP Gateway

El Docker MCP Gateway puede actuar como proxy de este servidor dentro de un contenedor. Dos enfoques:

Opción A: Ejecutar directamente a través de Docker

Construya una imagen de contenedor y haga referencia a ella en la configuración de su cliente MCP:

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

Luego, en cualquier configuración de cliente MCP:

{
  "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"
      ]
    }
  }
}

Opción B: Registrar con Docker MCP Gateway

Si tiene Docker Desktop con el kit de herramientas MCP:

docker mcp gateway run

Configure el perfil de la puerta de enlace para incluir el servidor nutanix. La puerta de enlace expone entonces todos los servidores MCP registrados como un único punto final unificado.

En su cliente de IA, apunte a la puerta de enlace:

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

La puerta de enlace gestiona el enrutamiento, el ciclo de vida y el aislamiento de credenciales.

Estrategia de versiones de API

Descubrimiento de hosts de Prism Element

Utilice list_clusters para encontrar los UUID de los clústeres, luego list_hosts para encontrar las IP de los CVM. Esas IP de CVM se pueden utilizar como pe_host en las herramientas de Prism Element.

Desarrollo

# Lint
ruff check src/

# Type check
mypy src/

# Test
pytest

Referencias

• Documentación de la API v4 de Nutanix

• Portal de desarrolladores de Nutanix

• API v3 de Prism Central

• API v2 de Prism Element

• Especificación del protocolo MCP