hawkeye-mcp-server 1.0.0

package/build/utils/http-client.js

@@ -0,0 +1,133 @@
+/**
+ * HTTP client wrapper with retry logic and better error handling
+ * Wraps axios with exponential backoff and standardized error handling
+ */
+import axios from 'axios';
+import { CONSTANTS } from '../config/config.js';
+import { logger } from './logger.js';
+import { isRetryableError } from './errors.js';
+/**
+ * HTTP client with retry logic
+ */
+export class HttpClient {
+    client;
+    maxRetries;
+    baseDelay;
+    backoffMultiplier;
+    constructor(baseURL, defaultTimeout = CONSTANTS.TIMEOUTS.DEFAULT_REQUEST) {
+        this.client = axios.create({
+            baseURL,
+            timeout: defaultTimeout,
+            headers: {
+                // Don't set Content-Type as default - it causes issues with GET requests
+                // Content-Type will be set per-request for POST/PUT/PATCH
+                'Accept': CONSTANTS.HEADERS.ACCEPT,
+                'X-Client-Identifier': CONSTANTS.HEADERS.CLIENT_IDENTIFIER,
+            },
+        });
+        this.maxRetries = CONSTANTS.RETRY.MAX_ATTEMPTS;
+        this.baseDelay = CONSTANTS.RETRY.BACKOFF_MS;
+        this.backoffMultiplier = CONSTANTS.RETRY.BACKOFF_MULTIPLIER;
+    }
+    /**
+     * Set authorization header
+     */
+    setAuthToken(token) {
+        this.client.defaults.headers.common['Authorization'] = `Bearer ${token}`;
+    }
+    /**
+     * Clear authorization header
+     */
+    clearAuthToken() {
+        delete this.client.defaults.headers.common['Authorization'];
+    }
+    /**
+     * Execute request with retry logic
+     */
+    async executeWithRetry(requestFn, attempt = 0) {
+        try {
+            return await requestFn();
+        }
+        catch (error) {
+            // Check if we should retry
+            if (attempt < this.maxRetries && isRetryableError(error)) {
+                const delay = this.baseDelay * Math.pow(this.backoffMultiplier, attempt);
+                logger.warn(`Request failed (attempt ${attempt + 1}/${this.maxRetries}), retrying in ${delay}ms`, {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                // Wait before retrying
+                await new Promise(resolve => setTimeout(resolve, delay));
+                // Retry
+                return this.executeWithRetry(requestFn, attempt + 1);
+            }
+            // No more retries or not retryable
+            throw error;
+        }
+    }
+    /**
+     * GET request
+     */
+    async get(url, config) {
+        logger.debug(`GET ${url}`, config?.params);
+        return this.executeWithRetry(() => this.client.get(url, config));
+    }
+    /**
+     * POST request
+     */
+    async post(url, data, config) {
+        logger.debug(`POST ${url}`, { data });
+        // Set Content-Type for POST requests
+        const requestConfig = {
+            ...config,
+            headers: {
+                'Content-Type': CONSTANTS.HEADERS.CONTENT_TYPE,
+                ...config?.headers,
+            },
+        };
+        return this.executeWithRetry(() => this.client.post(url, data, requestConfig));
+    }
+    /**
+     * PUT request
+     */
+    async put(url, data, config) {
+        logger.debug(`PUT ${url}`, { data });
+        // Set Content-Type for PUT requests
+        const requestConfig = {
+            ...config,
+            headers: {
+                'Content-Type': CONSTANTS.HEADERS.CONTENT_TYPE,
+                ...config?.headers,
+            },
+        };
+        return this.executeWithRetry(() => this.client.put(url, data, requestConfig));
+    }
+    /**
+     * DELETE request
+     */
+    async delete(url, config) {
+        logger.debug(`DELETE ${url}`);
+        return this.executeWithRetry(() => this.client.delete(url, config));
+    }
+    /**
+     * PATCH request
+     */
+    async patch(url, data, config) {
+        logger.debug(`PATCH ${url}`, { data });
+        // Set Content-Type for PATCH requests
+        const requestConfig = {
+            ...config,
+            headers: {
+                'Content-Type': CONSTANTS.HEADERS.CONTENT_TYPE,
+                ...config?.headers,
+            },
+        };
+        return this.executeWithRetry(() => this.client.patch(url, data, requestConfig));
+    }
+    /**
+     * Get the underlying Axios instance for advanced usage
+     */
+    getAxiosInstance() {
+        return this.client;
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/build/utils/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/utils/http-client.ts"],"names":[],"mappings":"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"}

package/build/utils/logger.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Logging utilities for Hawkeye MCP Server
+ *
+ * Important: In MCP servers, we use stderr for debug/log messages
+ * and stdout is reserved for MCP protocol communication only.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Logger class for structured logging to stderr
+ */
+declare class Logger {
+    private enabled;
+    private minLevel;
+    constructor();
+    private shouldLog;
+    private formatMessage;
+    /**
+     * Log debug message (lowest priority)
+     */
+    debug(message: string, data?: any): void;
+    /**
+     * Log informational message
+     */
+    info(message: string, data?: any): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, data?: any): void;
+    /**
+     * Log error message (highest priority)
+     */
+    error(message: string, error?: Error | any): void;
+}
+export declare const logger: Logger;
+export {};

package/build/utils/logger.js

@@ -0,0 +1,77 @@
+/**
+ * Logging utilities for Hawkeye MCP Server
+ *
+ * Important: In MCP servers, we use stderr for debug/log messages
+ * and stdout is reserved for MCP protocol communication only.
+ */
+/**
+ * Logger class for structured logging to stderr
+ */
+class Logger {
+    enabled;
+    minLevel;
+    constructor() {
+        this.enabled = process.env.HAWKEYE_LOG_ENABLED !== 'false';
+        this.minLevel = process.env.HAWKEYE_LOG_LEVEL || 'info';
+    }
+    shouldLog(level) {
+        if (!this.enabled)
+            return false;
+        const levels = ['debug', 'info', 'warn', 'error'];
+        const currentLevelIndex = levels.indexOf(this.minLevel);
+        const messageLevelIndex = levels.indexOf(level);
+        return messageLevelIndex >= currentLevelIndex;
+    }
+    formatMessage(level, message, data) {
+        const timestamp = new Date().toISOString();
+        const levelStr = level.toUpperCase().padEnd(5);
+        let output = `[${timestamp}] ${levelStr} ${message}`;
+        if (data !== undefined) {
+            if (typeof data === 'object') {
+                output += `\n${JSON.stringify(data, null, 2)}`;
+            }
+            else {
+                output += ` ${data}`;
+            }
+        }
+        return output;
+    }
+    /**
+     * Log debug message (lowest priority)
+     */
+    debug(message, data) {
+        if (this.shouldLog('debug')) {
+            console.error(this.formatMessage('debug', message, data));
+        }
+    }
+    /**
+     * Log informational message
+     */
+    info(message, data) {
+        if (this.shouldLog('info')) {
+            console.error(this.formatMessage('info', message, data));
+        }
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, data) {
+        if (this.shouldLog('warn')) {
+            console.error(this.formatMessage('warn', message, data));
+        }
+    }
+    /**
+     * Log error message (highest priority)
+     */
+    error(message, error) {
+        if (this.shouldLog('error')) {
+            const errorData = error instanceof Error
+                ? { message: error.message, stack: error.stack }
+                : error;
+            console.error(this.formatMessage('error', message, errorData));
+        }
+    }
+}
+// Export singleton instance
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/build/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,MAAM;IACF,OAAO,CAAU;IACjB,QAAQ,CAAW;IAE3B;QACE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,OAAO,CAAC;QAC3D,IAAI,CAAC,QAAQ,GAAI,OAAO,CAAC,GAAG,CAAC,iBAA8B,IAAI,MAAM,CAAC;IACxE,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAEhC,MAAM,MAAM,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9D,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEhD,OAAO,iBAAiB,IAAI,iBAAiB,CAAC;IAChD,CAAC;IAEO,aAAa,CAAC,KAAe,EAAE,OAAe,EAAE,IAAU;QAChE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/C,IAAI,MAAM,GAAG,IAAI,SAAS,KAAK,QAAQ,IAAI,OAAO,EAAE,CAAC;QAErD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,IAAU;QAC/B,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,IAAU;QAC9B,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,IAAU;QAC9B,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,KAAmB;QACxC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,KAAK,YAAY,KAAK;gBACtC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;gBAChD,CAAC,CAAC,KAAK,CAAC;YAEV,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/build/utils/validation.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Validation schemas for MCP tool inputs
+ * Uses Zod for runtime type validation (no eval!)
+ */
+import { z } from 'zod';
+export declare const InvestigateAlertInputSchema: z.ZodObject<{
+    alert_id: z.ZodString;
+    project_uuid: z.ZodOptional<z.ZodString>;
+    wait_for_completion: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    max_wait_seconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    alert_id: string;
+    wait_for_completion: boolean;
+    max_wait_seconds: number;
+    project_uuid?: string | undefined;
+}, {
+    alert_id: string;
+    project_uuid?: string | undefined;
+    wait_for_completion?: boolean | undefined;
+    max_wait_seconds?: number | undefined;
+}>;
+export declare const CreateInvestigationInputSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    timeframe: z.ZodOptional<z.ZodString>;
+    start_time: z.ZodOptional<z.ZodString>;
+    end_time: z.ZodOptional<z.ZodString>;
+    project_uuid: z.ZodOptional<z.ZodString>;
+    wait_for_completion: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    max_wait_seconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    stream_updates: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    wait_for_completion: boolean;
+    max_wait_seconds: number;
+    prompt: string;
+    stream_updates: boolean;
+    project_uuid?: string | undefined;
+    timeframe?: string | undefined;
+    start_time?: string | undefined;
+    end_time?: string | undefined;
+}, {
+    prompt: string;
+    project_uuid?: string | undefined;
+    wait_for_completion?: boolean | undefined;
+    max_wait_seconds?: number | undefined;
+    timeframe?: string | undefined;
+    start_time?: string | undefined;
+    end_time?: string | undefined;
+    stream_updates?: boolean | undefined;
+}>;
+export declare const GetInvestigationStatusInputSchema: z.ZodObject<{
+    session_uuid: z.ZodString;
+    project_uuid: z.ZodOptional<z.ZodString>;
+    include_full_details: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    session_uuid: string;
+    include_full_details: boolean;
+    project_uuid?: string | undefined;
+}, {
+    session_uuid: string;
+    project_uuid?: string | undefined;
+    include_full_details?: boolean | undefined;
+}>;
+export declare const ContinueInvestigationInputSchema: z.ZodObject<{
+    session_uuid: z.ZodString;
+    follow_up_prompt: z.ZodString;
+    project_uuid: z.ZodOptional<z.ZodString>;
+    wait_for_completion: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    max_wait_seconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    session_uuid: string;
+    wait_for_completion: boolean;
+    max_wait_seconds: number;
+    follow_up_prompt: string;
+    project_uuid?: string | undefined;
+}, {
+    session_uuid: string;
+    follow_up_prompt: string;
+    project_uuid?: string | undefined;
+    wait_for_completion?: boolean | undefined;
+    max_wait_seconds?: number | undefined;
+}>;
+export declare const ListProjectsInputSchema: z.ZodObject<{
+    include_inactive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    include_inactive: boolean;
+}, {
+    include_inactive?: boolean | undefined;
+}>;
+export declare const ListRecentInvestigationsInputSchema: z.ZodObject<{
+    project_uuid: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    filter_by_alert_id: z.ZodOptional<z.ZodString>;
+    filter_by_status: z.ZodOptional<z.ZodEnum<["completed", "in_progress", "failed"]>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    project_uuid?: string | undefined;
+    filter_by_alert_id?: string | undefined;
+    filter_by_status?: "completed" | "in_progress" | "failed" | undefined;
+}, {
+    project_uuid?: string | undefined;
+    limit?: number | undefined;
+    filter_by_alert_id?: string | undefined;
+    filter_by_status?: "completed" | "in_progress" | "failed" | undefined;
+}>;
+export declare const ConfigureDefaultsInputSchema: z.ZodObject<{
+    default_project_uuid: z.ZodOptional<z.ZodString>;
+    default_organization_uuid: z.ZodOptional<z.ZodString>;
+    default_timeframe: z.ZodOptional<z.ZodString>;
+    enable_streaming: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    default_project_uuid?: string | undefined;
+    default_organization_uuid?: string | undefined;
+    default_timeframe?: string | undefined;
+    enable_streaming?: boolean | undefined;
+}, {
+    default_project_uuid?: string | undefined;
+    default_organization_uuid?: string | undefined;
+    default_timeframe?: string | undefined;
+    enable_streaming?: boolean | undefined;
+}>;
+/**
+ * Validate and parse input against a Zod schema
+ */
+export declare function validateInput<T>(schema: z.ZodSchema<T>, input: unknown): T;
+/**
+ * Safe validation that returns errors instead of throwing
+ */
+export declare function safeValidateInput<T>(schema: z.ZodSchema<T>, input: unknown): {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: z.ZodError;
+};

package/build/utils/validation.js

@@ -0,0 +1,68 @@
+/**
+ * Validation schemas for MCP tool inputs
+ * Uses Zod for runtime type validation (no eval!)
+ */
+import { z } from 'zod';
+// ============================================================================
+// Tool Input Schemas
+// ============================================================================
+export const InvestigateAlertInputSchema = z.object({
+    alert_id: z.string().min(1, 'Alert ID is required'),
+    project_uuid: z.string().uuid().optional(),
+    wait_for_completion: z.boolean().optional().default(false),
+    max_wait_seconds: z.number().int().positive().optional().default(300),
+});
+export const CreateInvestigationInputSchema = z.object({
+    prompt: z.string().min(1, 'Prompt is required'),
+    timeframe: z.string().optional(),
+    start_time: z.string().datetime().optional(),
+    end_time: z.string().datetime().optional(),
+    project_uuid: z.string().uuid().optional(),
+    wait_for_completion: z.boolean().optional().default(false),
+    max_wait_seconds: z.number().int().positive().optional().default(300),
+    stream_updates: z.boolean().optional().default(false),
+});
+export const GetInvestigationStatusInputSchema = z.object({
+    session_uuid: z.string().uuid('Invalid session UUID'),
+    project_uuid: z.string().uuid().optional(),
+    include_full_details: z.boolean().optional().default(true),
+});
+export const ContinueInvestigationInputSchema = z.object({
+    session_uuid: z.string().uuid('Invalid session UUID'),
+    follow_up_prompt: z.string().min(1, 'Follow-up prompt is required'),
+    project_uuid: z.string().uuid().optional(),
+    wait_for_completion: z.boolean().optional().default(false),
+    max_wait_seconds: z.number().int().positive().optional().default(300),
+});
+export const ListProjectsInputSchema = z.object({
+    include_inactive: z.boolean().optional().default(false),
+});
+export const ListRecentInvestigationsInputSchema = z.object({
+    project_uuid: z.string().uuid().optional(),
+    limit: z.number().int().positive().optional().default(10),
+    filter_by_alert_id: z.string().optional(),
+    filter_by_status: z.enum(['completed', 'in_progress', 'failed']).optional(),
+});
+export const ConfigureDefaultsInputSchema = z.object({
+    default_project_uuid: z.string().uuid().optional(),
+    default_organization_uuid: z.string().optional(),
+    default_timeframe: z.string().optional(),
+    enable_streaming: z.boolean().optional(),
+});
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Validate and parse input against a Zod schema
+ */
+export function validateInput(schema, input) {
+    return schema.parse(input);
+}
+/**
+ * Safe validation that returns errors instead of throwing
+ */
+export function safeValidateInput(schema, input) {
+    const result = schema.safeParse(input);
+    return result;
+}
+//# sourceMappingURL=validation.js.map

package/build/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "hawkeye-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP Server for Hawkeye automated incident investigation and root cause analysis",
+  "private": false,
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "hawkeye-mcp": "build/index.js"
+  },
+  "files": [
+    "build/**/*",
+    "README.md",
+    "INSTALLATION.md",
+    "USAGE.md",
+    "SPECIFICATION.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "start": "node build/index.js",
+    "build": "tsc && chmod 755 build/index.js",
+    "typecheck": "tsc --noEmit",
+    "prestart": "npm run build",
+    "prepublishOnly": "npm run build",
+    "test:install": "node build/index.js --version"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "hawkeye",
+    "neubird",
+    "incident-investigation",
+    "rca",
+    "root-cause-analysis",
+    "cloud-monitoring",
+    "observability",
+    "cursor",
+    "claude",
+    "ai-agent"
+  ],
+  "author": "Neubird AI <support@neubird.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/neubird/solutions"
+  },
+  "homepage": "https://github.com/neubird/solutions/tree/main/hawkeye-mcp",
+  "bugs": {
+    "email": "support@neubird.ai"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.0",
+    "axios": "^1.9.0",
+    "dotenv": "^16.4.5",
+    "zod": "^3.24.3",
+    "json-schema-to-zod": "^2.6.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.2",
+    "typescript": "^5.8.3"
+  }
+}