Nutanix MCP Server

Сервер MCP (Model Context Protocol), который предоставляет API Nutanix Prism Central и Prism Element в качестве инструментов для ИИ-ассистентов, таких как GitHub Copilot, Claude и других.

Возможности

• Prism Central (v4 API) — управление ВМ, инвентаризация кластеров, управление хостами

• Prism Element (v2 API) — прямой доступ к кластеру для работы с хранилищами, дисками, оповещениями и доменами защиты

• Отчеты о конфигурации (As-Built Reports) — создание подробной документации в формате Markdown с диаграммами Excalidraw на уровне среды, кластера или ВМ

• Маршрутизация версий API — приоритет v4, с переходом на v3/v2 при необходимости

• Асинхронность — неблокирующий HTTP-клиент с использованием httpx

Related MCP server: nutanix-mcp

Доступные инструменты

Управление ВМ (Prism Central v4)

Управление кластерами (Prism Central v4)

Сеть и образы (Prism Central v4)

Prism Element (v2 — прямой доступ к кластеру)

Отчеты о конфигурации (As-Built Reports)

Отчеты выводят документацию в формате Markdown и JSON-диаграммы Excalidraw для визуального представления топологии.

Ресурсы MCP (просмотр на основе URI)

Сервер предоставляет ресурсы через URI nutanix://, позволяя LLM просматривать сущности без явных вызовов инструментов:

Промпты MCP

Установка

Предварительные требования

• Python 3.10+

• Сетевой доступ к экземпляру Prism Central (порт 9440)

• Учетные данные Nutanix с доступом к API

Установка

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

Или с зависимостями для разработки:

pip install -e ".[dev]"

Настройка

Скопируйте .env.example в .env и введите свои учетные данные:

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

Запуск

nutanix-mcp

Или напрямую:

python -m nutanix_mcp

Настройка клиента MCP

Этот сервер использует транспорт stdio — он обменивается данными через stdin/stdout. Каждый клиент настраивает команду для запуска процесса сервера.

Совет: Храните учетные данные в переменных окружения или файле .env, никогда не сохраняйте их в конфигурационных файлах, которые попадают в систему контроля версий.

Claude Code (CLI)

Добавьте сервер в свой проект с помощью команды claude mcp add:

claude mcp add nutanix -- python -m nutanix_mcp

Или вручную создайте/отредактируйте .mcp.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"
      }
    }
  }
}

Для доступности для всех проектов пользователя добавьте конфигурацию в ~/.claude.json.

Claude Desktop

Отредактируйте файл конфигурации по адресу:

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

Полностью перезапустите Claude Desktop после редактирования.

GitHub Copilot (VS Code)

Добавьте в .vscode/mcp.json в вашей рабочей области:

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

Добавьте в opencode.json (или opencode.jsonc) в корне проекта:

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

Примечание: OpenCode использует "command" как массив и "environment" вместо "env".

Docker MCP Gateway

Docker MCP Gateway может проксировать этот сервер внутри контейнера. Есть два подхода:

Вариант A: Запуск напрямую через Docker

Соберите образ контейнера и укажите его в конфигурации клиента 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"]

Затем в любой конфигурации клиента 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"
      ]
    }
  }
}

Вариант B: Регистрация в Docker MCP Gateway

Если у вас есть Docker Desktop с набором инструментов MCP:

docker mcp gateway run

Настройте профиль шлюза, чтобы включить сервер nutanix. Шлюз затем предоставит все зарегистрированные серверы MCP как единую унифицированную точку доступа.

В вашем ИИ-клиенте укажите на шлюз:

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

Шлюз берет на себя маршрутизацию, управление жизненным циклом и изоляцию учетных данных.

Стратегия версий API

Обнаружение хостов Prism Element

Используйте list_clusters для поиска UUID кластеров, затем list_hosts для поиска IP-адресов CVM. Эти IP-адреса CVM можно использовать как pe_host в инструментах Prism Element.

Разработка

# Lint
ruff check src/

# Type check
mypy src/

# Test
pytest

Ссылки

• Документация Nutanix v4 API

• Портал разработчиков Nutanix

• Prism Central v3 API

• Prism Element v2 API

• Спецификация протокола MCP