CMMS MCP Server

Instructions

Implementation Reference

• src/index.ts:868-889 (handler)

  The handler implementation for the acknowledge_alert tool, which updates the acknowledgment status of an alert.

  private handleAcknowledgeAlert(args: {
    alertId: string;
    acknowledgedBy: string;
  }) {
    const alert = mockAlerts.find((a) => a.id === args.alertId);
    if (!alert) {
      throw new Error(`Alert not found: ${args.alertId}`);
    }
  
    alert.acknowledged = true;
    alert.acknowledgedBy = args.acknowledgedBy;
    alert.acknowledgedAt = new Date().toISOString();
  
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(alert, null, 2),
        },
      ],
    };
  }

• src/index.ts:352-369 (schema)

  The tool definition (schema) for acknowledge_alert.

  {
    name: "acknowledge_alert",
    description: "Acknowledge an IoT alert.",
    inputSchema: {
      type: "object",
      properties: {
        alertId: {
          type: "string",
          description: "Alert ID to acknowledge",
        },
        acknowledgedBy: {
          type: "string",
          description: "User ID acknowledging the alert",
        },
      },
      required: ["alertId", "acknowledgedBy"],
    },
  },

• src/index.ts:406-407 (registration)

  The tool call routing for acknowledge_alert in the CallToolRequestSchema handler.

  case "acknowledge_alert":
    return this.handleAcknowledgeAlert(args as any);