# MCP Nutanix

A Model Context Protocol (MCP) server for interacting with Nutanix Prism Central APIs through Large Language Models (LLMs).

## ⚠️ Disclaimer

**THIS IS AN EXPERIMENTAL PROJECT**

This project was created as a personal project to explore the capabilities of the Model Context Protocol frameworks in Go. It is:

- **NOT** an official Nutanix product or tool
- **NOT** supported, endorsed, or maintained by Nutanix
- **NOT** suitable for production environments
- **PROVIDED AS-IS** with no warranties or guarantees

**USE AT YOUR OWN RISK**: The author takes no responsibility for any issues, damages, or outages that may result from using this code.

## Overview

This MCP server allows LLMs to interact with Nutanix Prism Central by:

1. Connecting to a Prism Central instance with user credentials
2. Listing various resources (VMs, Clusters, Hosts, etc.)
3. Retrieving specific resource details via URI-based access

The 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.

## Getting Started

### Prerequisites

- Go 1.23 or higher
- Access to a Nutanix Prism Central instance
- Tools like `make` and `go fmt` for building

### Building

```bash
# Clone the repository
git clone https://github.com/thunderboltsid/mcp-nutanix.git
cd mcp-nutanix

# Build the MCP server
make build
```

## Credential Configuration

The server supports two credential methods:

1. **Interactive credentials** (default) - Works with Claude via MCP prompts
2. **Static credentials** - Required for tools like Cursor that don't support interactive prompts

## MCP Client Configuration

To use this server with MCP clients, you need to configure the client to connect to the server.

### Claude Desktop/Code

Create or update `~/.anthropic/claude_desktop.json`:

```json
{
  "mcpServers": {
    "nutanix": {
      "command": "/path/to/mcp-nutanix"
    }
  }
}
```

Claude will prompt you for credentials when first using the server.

### Cursor

For Cursor, you need to provide static credentials via environment variables since it doesn't support interactive prompts.

Create or update `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "nutanix": {
      "command": "/path/to/mcp-nutanix",
      "env": {
        "NUTANIX_ENDPOINT": "your-prism-central-ip-or-hostname",
        "NUTANIX_USERNAME": "your-username", 
        "NUTANIX_PASSWORD": "your-password",
        "NUTANIX_INSECURE": "true"
      }
    }
  }
}
```

**Environment Variables:**
- `NUTANIX_ENDPOINT` - Prism Central IP or hostname (required)
- `NUTANIX_USERNAME` - API username (required)
- `NUTANIX_PASSWORD` - API password (required)
- `NUTANIX_INSECURE` - Set to "true" for self-signed certificates (optional)

### Other MCP Clients

This 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.

## Usage

Once the MCP server is configured with your client and connected to your Prism Central instance, LLMs can interact with it through the MCP protocol.

### Resource Listing

To list resources, use the appropriate tool:

```
vms
clusters
hosts
images
subnets
```

The LLM will receive a JSON list of resources that it can parse and analyze.

### Resource Access

To access a specific resource, use a resource URI:

```
vm://{uuid}
cluster://{uuid}
host://{uuid}
```

The LLM will receive detailed JSON information about the specific resource.

## Development

### Project Structure

```
mcp-nutanix/
├── bin/                  # Compiled binaries
├── internal/             # Internal packages
│   ├── client/           # Prism Central client handling
│   ├── codegen/          # Code generation utilities
│   └── json/             # JSON helpers
├── pkg/                  # components
│   ├── prompts/          # MCP prompt implementations
│   ├── resources/        # Resource handlers
│   └── tools/            # Tool handlers
└── Makefile              # Build and utility commands
```

### Code Generation

The project uses code generation to create resource and tool handlers. To update these:

```bash
make generate
```

## Limitations

- Response size is limited by the MCP protocol
- Some resources with large response sizes may cause errors
- No pagination support in the current implementation
- Only supports read operations, no create/update/delete

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Acknowledgments

- [Nutanix](https://www.nutanix.com/) for creating the Prism API
- [Mark3Labs](https://github.com/mark3labs) for the MCP Go library
- [Nutanix Cloud Native](https://github.com/nutanix-cloud-native) for the Prism Go Client

## Contributing

This is an experimental project with no formal contribution process. Feel free to create issues or pull requests.