HPE OneView MCP Server

This project provides a Model Context Protocol (MCP) server for managing HPE OneView infrastructure. It is designed to be deployed as a Docker container and integrates with the HPE OneView REST API to enable AI agents to manage IT infrastructure.

Quick Start

To get started with the OneView MCP server, you will need to have Docker and Docker Compose installed.

1. Clone the repository:

   git clone https://github.com/your-username/oneview-mcp-server.git cd oneview-mcp-server

2. Create a

   Copy the .env.example file to .env and fill in the required environment variables.

   cp .env.example .env

3. Run the server:

   docker-compose up -d

The server will be running on port 5000 by default. You can change the port by setting the PORT environment variable in the .env file.

Environment Variable Configuration

The following environment variables are required to run the OneView MCP server:

Security Considerations

Credential Management

All credentials for the OneView MCP server are loaded exclusively from environment variables. It is crucial that you never hardcode, log, or display credentials in any output. The server is designed to fail fast on startup if the required credentials are missing.

Rate Limiting

The server implements rate limiting to prevent brute-force attacks on the OneView appliance.

SSL Certificate Handling

The ONEVIEW_VERIFY_SSL environment variable controls whether the SSL certificate of the OneView appliance is verified. By default, it is set to true. If you are using a self-signed certificate, you will need to set this variable to false.

Docker Deployment Guide

The OneView MCP server is designed to be deployed as a Docker container. The Dockerfile and docker-compose.yml files are provided to make it easy to build and run the server.

Building the Docker Image

To build the Docker image, run the following command:

Running the Docker Container

To run the Docker container, you can use the docker-compose.yml file provided.

API Endpoint Reference

The OneView MCP server exposes the following tools:

• oneview_list_servers: List all server hardware with details.

• oneview_get_server: Get specific server details by ID.

• oneview_power_server: Control server power state (On/Off/Reset).

• oneview_create_profile: Create a server profile from a template.

• oneview_delete_profile: Remove a server profile.

• oneview_list_networks: List configured networks.

• oneview_get_network_sets: Retrieve network set configurations.

• oneview_list_storage: List storage systems and pools.

Troubleshooting

Docker Connectivity Issues

If you are having trouble connecting to the OneView appliance from the Docker container, make sure that the container is on the same network as the appliance. You can use the docker network command to manage Docker networks.

OneView Connectivity Issues

If you are having trouble connecting to the OneView appliance, make sure that the ONEVIEW_IP, ONEVIEW_USERNAME, and ONEVIEW_PASSWORD environment variables are set correctly. You can also try setting the ONEVIEW_VERIFY_SSL environment variable to false if you are using a self-signed certificate.