CloudStack MCP Server

Instructions

Implementation Reference

• src/handlers/virtual-machine-handlers.ts:190-201 (handler)

  The handler function that implements the core logic for the 'deploy_virtual_machine' tool. It calls the CloudStack client to deploy the VM and returns a formatted text response with job ID and VM ID.

  async handleDeployVirtualMachine(args: any) {
    const result = await this.cloudStackClient.deployVirtualMachine(args);
    
    return {
      content: [
        {
          type: 'text',
          text: `Deployed virtual machine. Job ID: ${result.deployvirtualmachineresponse?.jobid}\nVM ID: ${result.deployvirtualmachineresponse?.id}`
        }
      ]
    };
  }

• src/tool-definitions/virtual-machine-tools.ts:109-155 (schema)

  The tool definition including name, description, and input schema (parameters with types, descriptions, and required fields) for 'deploy_virtual_machine'.

  {
    name: 'deploy_virtual_machine',
    description: 'Deploy a new virtual machine',
    inputSchema: {
      type: 'object',
      properties: {
        serviceofferingid: {
          type: 'string',
          description: 'Service offering ID',
        },
        templateid: {
          type: 'string',
          description: 'Template ID',
        },
        zoneid: {
          type: 'string',
          description: 'Zone ID',
        },
        name: {
          type: 'string',
          description: 'VM name',
        },
        displayname: {
          type: 'string',
          description: 'VM display name',
        },
        networkids: {
          type: 'string',
          description: 'Network IDs (comma-separated)',
        },
        securitygroupids: {
          type: 'string',
          description: 'Security group IDs (comma-separated)',
        },
        keypair: {
          type: 'string',
          description: 'SSH key pair name',
        },
        userdata: {
          type: 'string',
          description: 'User data (base64 encoded)',
        },
      },
      required: ['serviceofferingid', 'templateid', 'zoneid'],
      additionalProperties: false,
    },
  },

• src/server.ts:120-121 (registration)

  The switch case in the MCP server request handler that registers and routes calls to the 'deploy_virtual_machine' tool to its handler.

  case 'deploy_virtual_machine':
    return await this.vmHandlers.handleDeployVirtualMachine(args);

• src/cloudstack-client.ts:96-98 (helper)

  Helper method in the CloudStackClient class that wraps the API request for the 'deployVirtualMachine' CloudStack API command.

  async deployVirtualMachine(params: CloudStackParams): Promise<CloudStackResponse> {
    return this.request('deployVirtualMachine', params);
  }