Morpheus MCP Server

Morpheus MCP Server

An MCP (Model Context Protocol) server that connects Claude, Ollama, or any AI assistant to a live HPE Morpheus appliance. Speak in plain English — the AI translates your intent into Morpheus API calls and reports back what was done.

What it does

Covers the full Morpheus management lifecycle through natural language:

• Clouds — add, list, sync, and remove cloud integrations (VMware, Proxmox via plugin, AWS, KVM, OpenStack, etc.)
• Groups — create and list Morpheus groups/sites
• Virtual Images — register images from URLs, check status, delete
• Instances — provision, start, stop, restart, delete, and inspect instances
• Instance Discovery — list instance types, layouts, service plans, networks, datastores, resource pools
• Catalog — create and manage catalog item types and blueprints
• Tenants — create, inspect, and delete tenants (sub-accounts)
• Roles — create and manage RBAC roles
• Users — create users under the master tenant or a specific sub-tenant, assign roles
• Workflows and Tasks — list, inspect, and execute workflows on instances
• Process History — view execution history for instances or the appliance
• Release Validation — paste release notes and get an automated API pass/fail test report

Requirements

• Docker and Docker Compose (or Python 3.10+)
• A running HPE Morpheus appliance (version 7.x or 8.x)
• A Morpheus API token with admin or appropriate permissions
• Claude Desktop, Open WebUI (Ollama), or any MCP-compatible client

Setup

Step 1 — Create your config file

cp .env.example .env

Open .env and fill in three values:

MORPHEUS_URL=https://your-morpheus-instance.com
MORPHEUS_API_TOKEN=your-token-here
MORPHEUS_VERSION=8.1.0

How to get your API token:Morpheus UI → top-right user icon → API Access → Generate Token

Step 2 — Start the server

docker compose up --build -d

The server starts on port 8000 (change MCP_PORT in .env if needed).

Check it started correctly:

docker compose logs -f

You should see:

Connected to Morpheus 8.1.0 at https://... | user=admin role=System Admin
Morpheus MCP Server starting on port 8000
SSE endpoint: http://0.0.0.0:8000/sse

Step 3 — Connect your AI client

Claude Desktop

Open the Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add:

{
  "mcpServers": {
    "morpheus": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:8000/sse"
      ]
    }
  },
  "preferences": {
    "coworkScheduledTasksEnabled": true,
    "ccdScheduledTasksEnabled": true,
    "coworkWebSearchEnabled": true,
    "sidebarMode": "chat"
  }
}

Restart Claude Desktop. The morpheus tools appear automatically.

Open WebUI (Ollama)

Settings → Tools → Add Tool Server → URL: http://localhost:8000/sse

Use a model that supports tool calling: llama3.1, qwen2.5, mistral-nemo, or similar.

Example commands

Once connected, talk to the AI naturally:

"Check the Morpheus connection"
"List all configured clouds"
"What cloud types are available on this appliance?"
"Add a VMware cloud using vCenter at https://vcenter.lab/sdk"
"List all instance types"
"What service plans are available for VMware?"
"Provision a test VM called demo-01 on the VMware cloud"
"Show me all running instances"
"Stop instance 42"
"Create a tenant called Acme Corp"
"Add a read-only role and create a user under Acme Corp"
"List all workflows"
"Run workflow 5 on instance 12"
"Validate this release: [paste Morpheus release notes here]"

Switching Morpheus instances

Update .env with the new URL and token, then restart:

docker compose down
# edit .env
docker compose up -d

Running without Docker

python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env            # fill in your values
python server.py

Proxmox note

Proxmox is not a built-in Morpheus cloud type. It requires the community plugin to be installed first:

1. Download the plugin JAR from the HPE Morpheus Proxmox VE Plugin repository
2. Install it in Morpheus: Administration → Integrations → Plugins → Upload File
3. Once installed, run list_zone_types — the Proxmox code will appear
4. Use that code with add_cloud to register your Proxmox host

SSL certificates

Self-signed certificates are handled by default (MORPHEUS_VERIFY_SSL=false in .env). For production appliances with valid certificates, set MORPHEUS_VERIFY_SSL=true.

Moving to Proxmox or another host

Copy the project folder to the target machine, install Docker, and run the same docker compose up command. The .env file is the only thing that needs to change per environment.

Available Tools Reference