cimc-mcp

Instructions

Implementation Reference

• src/tools/thermal.ts:11-43 (handler)

  The getPowerStats async function is the handler that implements the tool logic. It queries three CIMC classes (computeMbPowerStats, equipmentPsu, powerBudget) using resolveClass and returns formatted JSON with power consumption statistics including motherboard power, power supplies, and power budget data.

  export async function getPowerStats(): Promise<string> {
    const mbPower = await resolveClass("computeMbPowerStats");
    const psus = await resolveClass("equipmentPsu");
    const budget = await resolveClass("powerBudget");
  
    return JSON.stringify(
      {
        motherboardPower: mbPower.map((p) => ({
          dn: p.dn,
          consumedPower: p.consumedPower,
          inputCurrent: p.inputCurrent,
          inputVoltage: p.inputVoltage,
        })),
        powerSupplies: psus.map((p) => ({
          dn: p.dn,
          id: p.id,
          power: p.power,
          voltage: p.voltage,
          thermal: p.thermal,
          operability: p.operability,
        })),
        powerBudget: budget.map((b) => ({
          dn: b.dn,
          powerConsumed: b.powerConsumed,
          powerAvailable: b.powerAvailable,
          powerCap: b.powerCap,
          powerCharacterization: b.powerCharacterization,
        })),
      },
      null,
      2,
    );
  }

• src/tools/thermal.ts:4-9 (schema)

  The getPowerStatsDef object defines the tool's metadata: name 'get_power_stats', description about power consumption statistics, and an empty inputSchema (z.object({})) indicating the tool takes no parameters.

  export const getPowerStatsDef = {
    name: "get_power_stats",
    description:
      "Detailed power consumption statistics: input voltage, current, consumed power, and power budget.",
    inputSchema: z.object({}),
  };

• src/index.ts:159-164 (registration)

  The tool is registered with the MCP server using server.tool(), passing the definition's name, description, inputSchema.shape, and wrapping the handler with error handling via wrapHandler(getPowerStats).

  server.tool(
    getPowerStatsDef.name,
    getPowerStatsDef.description,
    getPowerStatsDef.inputSchema.shape,
    wrapHandler(getPowerStats),
  );

• src/utils/client.ts:49-56 (helper)

  The resolveClass helper function queries all objects of a given class from the CIMC API. It's used by getPowerStats to fetch computeMbPowerStats, equipmentPsu, and powerBudget data via authenticated XML requests.

  export async function resolveClass(
    classId: string,
    hierarchical = false,
  ): Promise<Record<string, string>[]> {
    const xml = `<configResolveClass cookie="{cookie}" inHierarchical="${hierarchical}" classId="${classId}"/>`;
    const result = await authenticatedRequest(xml);
    return extractOutConfigs(result, "configResolveClass");
  }