Nutanix MCP Server Jp

This project is a Nutanix MCP server prototype based on FastAPI, used to obtain cluster and virtual machine information from Nutanix Prism Central and supports integration with the Dify platform for natural language query functionality.

Virtualization Monitoring #Nutanix #FastAPI #Cluster Management #Dify Integration .Python

rating : 2 points

downloads : 25

update time : 2025-04-28

What is the Nutanix MCP Server?

The Nutanix MCP Server is a REST API service based on FastAPI, used to interact with Nutanix Prism Central and obtain configuration information of clusters and virtual machines. As a Minimum Viable Product (MVP) of the Model Context Protocol (MCP), it provides a foundation for subsequent feature expansion.

How to use the Nutanix MCP Server?

You can obtain Nutanix environment information through simple API calls. You can directly access the API endpoints or use natural language queries through the Dify platform.

Applicable Scenarios

Suitable for operation and maintenance scenarios that require monitoring the status of Nutanix clusters and obtaining virtual machine information, as well as scenarios where Nutanix management needs to be integrated into automated workflows.

Main Features

Cluster Information RetrievalObtain basic information about Nutanix clusters through the /clusters endpoint, including UUID, name, and node configuration.

Virtual Machine Information RetrievalObtain information about virtual machines on Prism Central through the /vms endpoint, including name, vCPU, and memory configuration.

Dify Platform IntegrationProvide an OpenAPI schema file that can be integrated with the Dify platform to query Nutanix information using natural language.

Advantages and Limitations

Advantages

A simple and easy-to-use REST API interface

Seamless integration with Nutanix Prism Central

Support for natural language queries on the Dify platform

Configuration information is managed through the .env file, facilitating deployment

Limitations

The current version is an MVP with limited functionality

SSL certificate verification is disabled by default, not suitable for production environments

Only information queries are supported, and management operations are not supported

How to Use

Environment Preparation

Ensure that Python 3.12+ and pip 23.x+ are installed.

Clone the Repository

Get the project code from GitHub.

Set Environment Variables

Copy .env.example to .env and fill in your Nutanix Prism Central connection information.

Install Dependencies

Install the Python packages required for the project.

Start the Server

Start the MCP server using uvicorn.

Usage Examples

Monitor Cluster StatusRegularly check the cluster health status and resource usage.

Virtual Machine Inventory ManagementGet the configuration inventory of all virtual machines in the environment.

Frequently Asked Questions

Can this server be used in a production environment?

How to solve the SSL certificate verification problem?

How does the Dify platform connect to the MCP server?

Related Resources

Nutanix Prism Central API Documentation

Official Nutanix API documentation

FastAPI Documentation

Official documentation for the FastAPI framework

Dify Platform Documentation

Usage guide for the Dify platform

🚀 nutanix-mcp-server

A FastAPI implementation of the MCP (Model Context Protocol) server for interacting with Nutanix Prism Central, Nutanix clusters, and virtual machine information.

🚀 Quick Start

This project aims to implement a Minimum Viable Product (MVP) of the Model Context Protocol (MCP) server for the Nutanix environment. The main goal is to use FastAPI to obtain cluster information from Nutanix Prism Central. This MVP will serve as the foundation for future feature expansions, such as obtaining more types of information, performing model operations, and enhancing security.

Since this project is a prototype development, do not use it in a production environment.

📦 Installation

Operating Environment

Property	Details
Operating System	macOS, Linux, Windows (including WSL2)
Python Version	Recommended 3.12 or above
pip Version	Recommended 23.x or above
Nutanix Prism Central API Version	v4.0.2 (Cluster Management API)
Nutanix Prism Central API Version	v4.0 (Virtual Machine Management API)

Setup Steps

# Clone the repository
git clone https://github.com/takanorisuzuki/nutanix-mcp-server-jp.git
cd nutanix-mcp-server-jp

# Create and activate a virtual environment (optional)
python3 -m venv venv
source venv/bin/activate  # Use venv\Scripts\activate on Windows

# Install dependencies
pip install -r requirements.txt

# Copy the example .env file
cp .env.example .env

Configuration Method for the .env File

Create a .env file in the following format to define authentication and connection information:

PRISM_CENTRAL_IP=192.168.10.11
PRISM_CENTRAL_PORT=9440
PRISM_CENTRAL_USERNAME=admin
PRISM_CENTRAL_PASSWORD=your_password_here
# Verify the SSL certificate (comment out to disable SSL verification)
# PRISM_CENTRAL_VERIFY_SSL=false

⚠️ Important Note

Do not use plain text for the password in the .env file. It is recommended to use environment variables or encryption for storage.

💻 Usage Examples

Basic Usage

The project provides interfaces such as /clusters and /vms to interact with Nutanix Prism Central.

📚 Documentation

Changelog

2025-04-18: Version v0.1.0 released
- Implemented the /clusters and /vms interfaces.
- Integrated the connection to Nutanix Prism Central.
- Built a REST API service using FastAPI.
- Externalized authentication information and connection addresses to the .env file.
- Adjusted the OpenAPI scheme for Dify integration.

How to Contribute

Contributions are welcome. Please submit feature improvements or bug fixes via Pull Requests. Before making significant changes, please create an Issue for discussion.

License

This project is licensed under the conditions specified in the LICENSE file.

Future Expansion Plans

Add detailed information about virtual machines (e.g., NIC and disk configurations).
Implement an interface to display detailed information for each cluster separately.
Integrate the Nutanix API vmm and introduce operation-type APIs (e.g., starting/stopping virtual machines).
Support interactive operations with Dify.