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 fi