CloudStack MCP Server

Instructions

Implementation Reference

• src/handlers/network-handlers.ts:82-93 (handler)

  The main handler function that executes the tool logic: calls the CloudStack client to associate an IP address and formats the response as MCP content.

  async handleAssociateIpAddress(args: any) {
    const result = await this.cloudStackClient.associateIpAddress(args);
    
    return {
      content: [
        {
          type: 'text',
          text: `Associated IP address. Job ID: ${result.associateipaddressresponse?.jobid}\nIP ID: ${result.associateipaddressresponse?.id}`
        }
      ]
    };
  }

• src/tool-definitions/network-tools.ts:82-103 (schema)

  Tool definition including name, description, and input schema (parameters: zoneid, networkid, vpcid).

  {
    name: 'associate_ip_address',
    description: 'Acquire a new public IP address',
    inputSchema: {
      type: 'object',
      properties: {
        zoneid: {
          type: 'string',
          description: 'Zone ID',
        },
        networkid: {
          type: 'string',
          description: 'Network ID',
        },
        vpcid: {
          type: 'string',
          description: 'VPC ID',
        },
      },
      additionalProperties: false,
    },
  },

• src/server.ts:156-157 (registration)

  Tool registration in the MCP server: routes 'associate_ip_address' calls to the network handler.

  case 'associate_ip_address':
    return await this.networkHandlers.handleAssociateIpAddress(args);

• src/cloudstack-client.ts:197-199 (helper)

  CloudStack client helper method that sends the 'associateIpAddress' API request.

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