MCP Nutanix

1# MCP Nutanix
2 
3A Model Context Protocol (MCP) server for interacting with Nutanix Prism Central APIs through Large Language Models (LLMs).
4 
5## ⚠️ Disclaimer
6 
7**THIS IS AN EXPERIMENTAL PROJECT**
8 
9This project was created as a personal project to explore the capabilities of the Model Context Protocol frameworks in Go. It is:
10 
11- **NOT** an official Nutanix product or tool
12- **NOT** supported, endorsed, or maintained by Nutanix
13- **NOT** suitable for production environments
14- **PROVIDED AS-IS** with no warranties or guarantees
15 
16**USE AT YOUR OWN RISK**: The author takes no responsibility for any issues, damages, or outages that may result from using this code.
17 
18## Overview
19 
20This MCP server allows LLMs to interact with Nutanix Prism Central by:
21 
221. Connecting to a Prism Central instance with user credentials
232. Listing various resources (VMs, Clusters, Hosts, etc.)
243. Retrieving specific resource details via URI-based access
25 
26The implementation uses the [Prism Go Client](https://github.com/nutanix-cloud-native/prism-go-client) to communicate with Prism Central and the [MCP Go library](https://github.com/mark3labs/mcp-go) to implement the Model Context Protocol.
27 
28## Getting Started
29 
30### Prerequisites
31 
32- Go 1.23 or higher
33- Access to a Nutanix Prism Central instance
34- Tools like `make` and `go fmt` for building
35 
36### Building
37 
38```bash
39# Clone the repository
40git clone https://github.com/thunderboltsid/mcp-nutanix.git
41cd mcp-nutanix
42 
43# Build the MCP server
44make build
45```
46 
47## Credential Configuration
48 
49The server supports two credential methods:
50 
511. **Interactive credentials** (default) - Works with Claude via MCP prompts
522. **Static credentials** - Required for tools like Cursor that don't support interactive prompts
53 
54## MCP Client Configuration
55 
56To use this server with MCP clients, you need to configure the client to connect to the server.
57 
58### Claude Desktop/Code
59 
60Create or update `~/.anthropic/claude_desktop.json`:
61 
62```json
63{
64  "mcpServers": {
65    "nutanix": {
66      "command": "/path/to/mcp-nutanix"
67    }
68  }
69}
70```
71 
72Claude will prompt you for credentials when first using the server.
73 
74### Cursor
75 
76For Cursor, you need to provide static credentials via environment variables since it doesn't support interactive prompts.
77 
78Create or update `~/.cursor/mcp.json`:
79 
80```json
81{
82  "mcpServers": {
83    "nutanix": {
84      "command": "/path/to/mcp-nutanix",
85      "env": {
86        "NUTANIX_ENDPOINT": "your-prism-central-ip-or-hostname",
87        "NUTANIX_USERNAME": "your-username", 
88        "NUTANIX_PASSWORD": "your-password",
89        "NUTANIX_INSECURE": "true"
90      }
91    }
92  }
93}
94```
95 
96**Environment Variables:**
97- `NUTANIX_ENDPOINT` - Prism Central IP or hostname (required)
98- `NUTANIX_USERNAME` - API username (required)
99- `NUTANIX_PASSWORD` - API password (required)
100- `NUTANIX_INSECURE` - Set to "true" for self-signed certificates (optional)
101 
102### Other MCP Clients
103 
104This server follows the standard MCP protocol and should work with any MCP client that supports stdio transport. Refer to your client's documentation for configuration instructions.
105 
106## Usage
107 
108Once the MCP server is configured with your client and connected to your Prism Central instance, LLMs can interact with it through the MCP protocol.
109 
110### Resource Listing
111 
112To list resources, use the appropriate tool:
113 
114```
115vms
116clusters
117hosts
118images
119subnets
120```
121 
122The LLM will receive a JSON list of resources that it can parse and analyze.
123 
124### Resource Access
125 
126To access a specific resource, use a resource URI:
127 
128```
129vm://{uuid}
130cluster://{uuid}
131host://{uuid}
132```
133 
134The LLM will receive detailed JSON information about the specific resource.
135 
136## Development
137 
138### Project Structure
139 
140```
141mcp-nutanix/
142├── bin/                  # Compiled binaries
143├── internal/             # Internal packages
144│   ├── client/           # Prism Central client handling
145│   ├── codegen/          # Code generation utilities
146│   └── json/             # JSON helpers
147├── pkg/                  # components
148│   ├── prompts/          # MCP prompt implementations
149│   ├── resources/        # Resource handlers
150│   └── tools/            # Tool handlers
151└── Makefile              # Build and utility commands
152```
153 
154### Code Generation
155 
156The project uses code generation to create resource and tool handlers. To update these:
157 
158```bash
159make generate
160```
161 
162## Limitations
163 
164- Response size is limited by the MCP protocol
165- Some resources with large response sizes may cause errors
166- No pagination support in the current implementation
167- Only supports read operations, no create/update/delete
168 
169## License
170 
171This project is licensed under the MIT License - see the LICENSE file for details.
172 
173## Acknowledgments
174 
175- [Nutanix](https://www.nutanix.com/) for creating the Prism API
176- [Mark3Labs](https://github.com/mark3labs) for the MCP Go library
177- [Nutanix Cloud Native](https://github.com/nutanix-cloud-native) for the Prism Go Client
178 
179## Contributing
180 
181This is an experimental project with no formal contribution process. Feel free to create issues or pull requests.
182