morpheus-mcp-node

An MCP (Model Context Protocol) server for the Morpheus Data cloud management platform. This server enables AI assistants like Claude to interact directly with your Morpheus infrastructure — listing clouds, provisioning instances, managing networks, and more.

Features

| Tool | Description | |------|-------------| | list_instances | List all instances (VMs) | | get_health | Check Morpheus appliance health | | list_clouds | List all clouds (VMware, AWS, Azure, etc.) | | list_groups | List all groups | | list_instance_types | List available instance types | | list_plans | List service plans (sizes) | | list_layouts | List layouts for an instance type | | list_resource_pools | List resource pools for a cloud | | list_networks | List networks (filterable by cloud) | | create_instance | Provision a new VM with full config | | list_deployments | List deployments | | create_deployment | Create a new deployment |

Quick Start

1. Install

npm install -g morpheus-mcp-node

2. Configure Claude Desktop

Open your Claude Desktop config file and add:

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

{
  "mcpServers": {
    "morpheus": {
      "command": "npx",
      "args": ["-y", "morpheus-mcp-node"],
      "env": {
        "MORPHEUS_URL": "https://your-morpheus-url/",
        "MORPHEUS_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

3. Restart Claude Desktop

Quit Claude Desktop completely (Cmd+Q on macOS) and reopen it. The Morpheus tools will be available immediately.

Getting an Access Token

1. Log in to your Morpheus appliance
2. Go to User Settings → API Access
3. Generate a new access token

Usage Examples

Once configured, you can ask your AI assistant things like:

• "List all my clouds in Morpheus"
• "Show me the running instances"
• "Provision a new Ubuntu VM on VMware Cloud with 4GB RAM in dev environment"
• "Check the health of the Morpheus appliance"
• "What networks are available on cloud ID 6?"

Configuration

| Variable | Required | Description | |----------|----------|-------------| | MORPHEUS_URL | ✅ | Your Morpheus appliance URL (e.g., https://morpheus.example.com/) | | MORPHEUS_ACCESS_TOKEN | ✅ | API access token from Morpheus |

Both variables are passed via the env block in Claude Desktop config. No .env file needed.