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.