Waroom MCP

Instructions

Implementation Reference

• src/tools/incidents.ts:169-189 (handler)

  The handler function that executes the tool logic by calling WaroomClient.createIncidentMetrics and formatting the response as MCP content.

  async (params) => {
    try {
      const response = await waroomClient.createIncidentMetrics(
        params.incident_uuid,
        params.activity_action,
        params.triggered_at
      );
      return {
        content: [{
          type: 'text',
          text: JSON.stringify(response, null, 2)
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: 'text',
          text: `インシデントメトリクスの作成に失敗しました: ${error}`
        }]
      };
    }

• src/tools/incidents.ts:164-168 (schema)

  Zod input schema defining parameters for the tool: incident_uuid, activity_action, and triggered_at.

  {
    incident_uuid: z.string().uuid().describe('対象インシデントのUUID'),
    activity_action: z.enum(['detected', 'investigating', 'fixing', 'resolved', 'close', 'triggered', 'critical', 'high', 'low', 'info', 'unknown', 'unspecified', 'code_bug', 'configuration_error', 'deployment_failure', 'infrastructure_failure', 'operational_failure', 'third_party_outage', 'other']).describe('活動アクション（status: detected/investigating/fixing/resolved/close/triggered, severity: critical/high/low/info/unknown, root_cause: unspecified/code_bug/configuration_error/deployment_failure/infrastructure_failure/operational_failure/third_party_outage/other）'),
    triggered_at: z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?([+-]\d{2}:\d{2}|Z)$/).describe('実行時刻（ISO 8601形式、例: 2023-01-01T12:00:00Z）'),
  },

• src/main.ts:26-26 (registration)

  Top-level registration call that invokes createIncidentsTools to register the incidents tools group, including waroom_create_incident_metrics.

  createIncidentsTools(server, waroomClient);

• src/tools/incidents.ts:161-191 (registration)

  Direct registration of the waroom_create_incident_metrics tool using server.tool, including description, schema, and handler.

  server.tool(
    'waroom_create_incident_metrics',
    'インシデントメトリクスを作成します。レスポンス活動を記録し、TTD/TTA/TTI/TTF/TTRを更新します。',
    {
      incident_uuid: z.string().uuid().describe('対象インシデントのUUID'),
      activity_action: z.enum(['detected', 'investigating', 'fixing', 'resolved', 'close', 'triggered', 'critical', 'high', 'low', 'info', 'unknown', 'unspecified', 'code_bug', 'configuration_error', 'deployment_failure', 'infrastructure_failure', 'operational_failure', 'third_party_outage', 'other']).describe('活動アクション（status: detected/investigating/fixing/resolved/close/triggered, severity: critical/high/low/info/unknown, root_cause: unspecified/code_bug/configuration_error/deployment_failure/infrastructure_failure/operational_failure/third_party_outage/other）'),
      triggered_at: z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?([+-]\d{2}:\d{2}|Z)$/).describe('実行時刻（ISO 8601形式、例: 2023-01-01T12:00:00Z）'),
    },
    async (params) => {
      try {
        const response = await waroomClient.createIncidentMetrics(
          params.incident_uuid,
          params.activity_action,
          params.triggered_at
        );
        return {
          content: [{
            type: 'text',
            text: JSON.stringify(response, null, 2)
          }]
        };
      } catch (error) {
        return {
          content: [{
            type: 'text',
            text: `インシデントメトリクスの作成に失敗しました: ${error}`
          }]
        };
      }
    }
  );

• src/WaroomClient.ts:149-159 (helper)

  Supporting method in WaroomClient that performs the actual API call to create incident metrics.

  async createIncidentMetrics(incidentUuid: string, activityAction: string, triggeredAt: string) {
    try {
      const response = await this.axiosInstance.post(`${this.baseUrl}/incidents/${incidentUuid}/metrics`, {
        activity_action: activityAction,
        triggered_at: triggeredAt
      });
      return response.data;
    } catch (error) {
      throw new Error(`Failed to create incident metrics: ${error}`);
    }
  }