morpheus-mcp-server

Morpheus MCP Server

MCP server implementation for the HPE Morpheus Data hybrid cloud platform.

Installation

npm install -g argocd-mcp-server

Tools (24)

API Coverage

Category	Tools	Morpheus API Endpoints
Instances	list_instances, create_instance, get_instance, action_instance, delete_instance	/api/instances
Clouds	list_clouds, get_cloud, refresh_cloud	/api/zones
Automation	list_tasks, get_task, execute_task, list_workflows, get_workflow, execute_workflow	/api/tasks, /api/task-sets
Monitoring	health, list_incidents, get_incident, list_checks, get_check	/api/health, /api/monitoring
Users	list_users, get_user, create_user, list_roles	/api/users, /api/roles
Budgets	list_budgets, billing	/api/budgets, /api/billing
Activity	activity	/api/activity
Networks	list_networks, get_network	/api/networks
Backups	list_backups, get_backup, execute_backup	/api/backups
Universal API	morpheus_list_resource, morpheus_api_catalog, morpheus_api_get, morpheus_api_request	Any /api/* endpoint

Authentication

Two authentication modes are supported:

Option A — Static API Token

1. Log into your Morpheus appliance
2. Go to User Settings → API Access
3. Generate an API token
4. Set MORPHEUS_URL and MORPHEUS_TOKEN environment variables

Option B — Username/Password with Auto-Refresh (Recommended)

1. Set MORPHEUS_URL, MORPHEUS_USERNAME, and MORPHEUS_PASSWORD
2. The server auto-authenticates via OAuth (POST /oauth/token)
3. Tokens are proactively refreshed before expiry (at 80% of expires_in)
4. On 401 errors, the server refreshes the token and retries the request
5. If the refresh token expires, it falls back to a full re-login

No manual token rotation needed — ideal for long-running sessions.

MCP Client Configuration

Claude Desktop

With static token:

{
  "mcpServers": {
    "morpheus": {
      "command": "node",
      "args": ["/path/to/packages/morpheus-server/dist/index.js"],
      "env": {
        "MORPHEUS_URL": "https://morpheus.corp.com",
        "MORPHEUS_TOKEN": "your-token"
      }
    }
  }
}

With username/password (auto-refresh):

{
  "mcpServers": {
    "morpheus": {
      "command": "node",
      "args": ["/path/to/packages/morpheus-server/dist/index.js"],
      "env": {
        "MORPHEUS_URL": "https://morpheus.corp.com",
        "MORPHEUS_USERNAME": "admin",
        "MORPHEUS_PASSWORD": "your-password"
      }
    }
  }
}

VS Code (via extension)

Install the companion VS Code extension and configure in Settings.