hawkeye-mcp-server 1.0.0

package/build/config/config.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Configuration management for Hawkeye MCP Server
+ * Loads and validates environment variables and provides application constants
+ */
+export interface HawkeyeConfig {
+    email: string;
+    password: string;
+    baseUrl: string;
+    defaultProjectUuid?: string;
+    defaultOrganizationUuid: string;
+    defaultTimeframe: string;
+    enableStreaming: boolean;
+    maxPollAttempts: number;
+    pollIntervalMs: number;
+    tokenRefreshBufferMs: number;
+    projectCacheTtlMs: number;
+    serverName: string;
+    serverVersion: string;
+}
+/**
+ * Load and validate configuration from environment variables
+ */
+export declare function loadConfig(): HawkeyeConfig;
+/**
+ * Get the global configuration instance
+ */
+export declare function getConfig(): HawkeyeConfig;
+/**
+ * Constants used throughout the application
+ */
+export declare const CONSTANTS: {
+    readonly ENDPOINTS: {
+        readonly LOGIN: "/v1/user/login";
+        readonly PROJECTS: "/v1/project";
+        readonly SESSION_LIST: "/v1/inference/session/list";
+        readonly SESSION_CREATE: "/v1/inference/new_session";
+        readonly SESSION_PROMPT: "/v1/inference/session";
+        readonly SESSION_INSPECT: "/v1/inference/session/inspect";
+        readonly SESSION_REPORT: "/v1/inference/session_report";
+        readonly SESSION_SUMMARY: "/v1/inference/session/summary";
+        readonly INCIDENT_REPORT: "/v1/inference/incident_report";
+    };
+    readonly HEADERS: {
+        readonly CONTENT_TYPE: "application/json";
+        readonly ACCEPT: "application/json";
+        readonly CLIENT_IDENTIFIER: "mcp-server";
+    };
+    readonly TIMEOUTS: {
+        readonly DEFAULT_REQUEST: 30000;
+        readonly LONG_REQUEST: 60000;
+        readonly AUTH_REQUEST: 10000;
+    };
+    readonly RETRY: {
+        readonly MAX_ATTEMPTS: 3;
+        readonly BACKOFF_MS: 1000;
+        readonly BACKOFF_MULTIPLIER: 2;
+    };
+};

package/build/config/config.js

@@ -0,0 +1,100 @@
+/**
+ * Configuration management for Hawkeye MCP Server
+ * Loads and validates environment variables and provides application constants
+ */
+import dotenv from 'dotenv';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+// Get directory of current module
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Load environment variables from project root
+const envPath = join(__dirname, '../../.env');
+const result = dotenv.config({ path: envPath });
+// Debug: Log if .env was loaded successfully
+if (result.error) {
+    console.error('[CONFIG] Failed to load .env file:', result.error.message);
+    console.error('[CONFIG] Tried path:', envPath);
+}
+else {
+    console.error('[CONFIG] Successfully loaded .env from:', envPath);
+    console.error('[CONFIG] HAWKEYE_EMAIL:', process.env.HAWKEYE_EMAIL ? '✓ Set' : '✗ Not set');
+    console.error('[CONFIG] HAWKEYE_PASSWORD:', process.env.HAWKEYE_PASSWORD ? '✓ Set' : '✗ Not set');
+    console.error('[CONFIG] HAWKEYE_BASE_URL:', process.env.HAWKEYE_BASE_URL || 'Using default');
+}
+/**
+ * Load and validate configuration from environment variables
+ */
+export function loadConfig() {
+    const email = process.env.HAWKEYE_EMAIL;
+    const password = process.env.HAWKEYE_PASSWORD;
+    if (!email || !password) {
+        throw new Error('Missing required environment variables: HAWKEYE_EMAIL and HAWKEYE_PASSWORD must be set');
+    }
+    return {
+        // Required
+        email,
+        password,
+        baseUrl: process.env.HAWKEYE_BASE_URL || 'https://sandbox.app.neubird.ai/api',
+        // Optional with defaults
+        defaultProjectUuid: process.env.HAWKEYE_DEFAULT_PROJECT_UUID,
+        defaultOrganizationUuid: process.env.HAWKEYE_DEFAULT_ORGANIZATION_UUID || 'ORGANIZATION_NAME_ROOT',
+        defaultTimeframe: process.env.HAWKEYE_DEFAULT_TIMEFRAME || 'last 1 hour',
+        enableStreaming: process.env.HAWKEYE_ENABLE_STREAMING !== 'false', // Default true
+        // Performance
+        maxPollAttempts: parseInt(process.env.HAWKEYE_MAX_POLL_ATTEMPTS || '30', 10),
+        pollIntervalMs: parseInt(process.env.HAWKEYE_POLL_INTERVAL_MS || '2000', 10),
+        tokenRefreshBufferMs: 5 * 60 * 1000, // 5 minutes
+        projectCacheTtlMs: 5 * 60 * 1000, // 5 minutes
+        // Server metadata
+        serverName: 'hawkeye-mcp-server',
+        serverVersion: '2.0.0',
+    };
+}
+// Global configuration instance
+let config = null;
+/**
+ * Get the global configuration instance
+ */
+export function getConfig() {
+    if (!config) {
+        config = loadConfig();
+    }
+    return config;
+}
+/**
+ * Constants used throughout the application
+ */
+export const CONSTANTS = {
+    // API endpoints
+    ENDPOINTS: {
+        LOGIN: '/v1/user/login',
+        PROJECTS: '/v1/project',
+        SESSION_LIST: '/v1/inference/session/list',
+        SESSION_CREATE: '/v1/inference/new_session',
+        SESSION_PROMPT: '/v1/inference/session',
+        SESSION_INSPECT: '/v1/inference/session/inspect',
+        SESSION_REPORT: '/v1/inference/session_report',
+        SESSION_SUMMARY: '/v1/inference/session/summary',
+        INCIDENT_REPORT: '/v1/inference/incident_report',
+    },
+    // Headers
+    HEADERS: {
+        CONTENT_TYPE: 'application/json',
+        ACCEPT: 'application/json',
+        CLIENT_IDENTIFIER: 'mcp-server',
+    },
+    // Timeouts
+    TIMEOUTS: {
+        DEFAULT_REQUEST: 30000, // 30 seconds
+        LONG_REQUEST: 60000, // 1 minute
+        AUTH_REQUEST: 10000, // 10 seconds
+    },
+    // Retry configuration
+    RETRY: {
+        MAX_ATTEMPTS: 3,
+        BACKOFF_MS: 1000,
+        BACKOFF_MULTIPLIER: 2,
+    },
+};
+//# sourceMappingURL=config.js.map

package/build/config/config.js.map

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

package/build/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Hawkeye MCP Server v2.0
+ * A Model Context Protocol server for AI-powered incident investigation
+ */
+export {};

package/build/index.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+/**
+ * Hawkeye MCP Server v2.0
+ * A Model Context Protocol server for AI-powered incident investigation
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+// Configuration and utilities
+import { getConfig } from './config/config.js';
+import { logger } from './utils/logger.js';
+import { formatErrorForMCP } from './utils/errors.js';
+import { HttpClient } from './utils/http-client.js';
+// Services
+import { AuthenticationService } from './services/auth.service.js';
+import { ProjectService } from './services/project.service.js';
+import { SessionService } from './services/session.service.js';
+// Tools
+import { getToolDefinitions } from './tools/index.js';
+/**
+ * Initialize services
+ */
+function initializeServices() {
+    const config = getConfig();
+    const httpClient = new HttpClient(config.baseUrl);
+    const authService = new AuthenticationService(httpClient);
+    const projectService = new ProjectService(httpClient, authService);
+    const sessionService = new SessionService(httpClient, authService);
+    return {
+        authService,
+        projectService,
+        sessionService,
+    };
+}
+/**
+ * Main server setup
+ */
+async function main() {
+    try {
+        const config = getConfig();
+        const services = initializeServices();
+        // Create MCP server
+        const server = new Server({
+            name: config.serverName,
+            version: config.serverVersion,
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Get all tool definitions
+        const toolDefinitions = getToolDefinitions();
+        const toolHandlers = new Map(toolDefinitions.map((def) => [def.tool.name, def.handler]));
+        /**
+         * Handler for listing available tools
+         */
+        server.setRequestHandler(ListToolsRequestSchema, async () => {
+            const tools = toolDefinitions.map((def) => def.tool);
+            return { tools };
+        });
+        /**
+         * Handler for tool execution
+         */
+        server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name: toolName, arguments: toolArgs } = request.params;
+            try {
+                // Get the tool handler
+                const handler = toolHandlers.get(toolName);
+                if (!handler) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        type: 'validation',
+                                        message: `Unknown tool: ${toolName}`,
+                                    },
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                // Execute the tool
+                const toolServices = {
+                    projectService: services.projectService,
+                    sessionService: services.sessionService,
+                };
+                const result = await handler(toolServices, toolArgs);
+                // Return the result
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                logger.error(`Error executing tool ${toolName}`, error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(formatErrorForMCP(error), null, 2),
+                        },
+                    ],
+                };
+            }
+        });
+        // Connect to transport
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        logger.info(`${config.serverName} v${config.serverVersion} started successfully`);
+        logger.info(`${toolDefinitions.length} tools registered`);
+    }
+    catch (error) {
+        logger.error('Fatal error during server startup', error);
+        process.exit(1);
+    }
+}
+/**
+ * Cleanup on shutdown
+ */
+async function cleanup() {
+    logger.info('Shutting down Hawkeye MCP server...');
+    process.exit(0);
+}
+// Signal handlers
+process.on('SIGINT', cleanup);
+process.on('SIGTERM', cleanup);
+// Start the server
+main().catch((error) => {
+    logger.error('Fatal error in main execution', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/services/auth.service.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Authentication service for Hawkeye API
+ * Handles login, token caching, and automatic token refresh
+ */
+import { HttpClient } from '../utils/http-client.js';
+/**
+ * Authentication service
+ */
+export declare class AuthenticationService {
+    private httpClient;
+    private tokenCache;
+    private config;
+    constructor(httpClient: HttpClient);
+    /**
+     * Get a valid access token, refreshing if necessary
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * Check if the cached token is still valid
+     */
+    private isTokenValid;
+    /**
+     * Login and cache the access token
+     */
+    private login;
+    /**
+     * Clear the cached token (useful for testing or forced re-authentication)
+     */
+    clearTokenCache(): void;
+    /**
+     * Check if user is authenticated (has valid cached token)
+     */
+    isAuthenticated(): boolean;
+}

package/build/services/auth.service.js

@@ -0,0 +1,96 @@
+/**
+ * Authentication service for Hawkeye API
+ * Handles login, token caching, and automatic token refresh
+ */
+import { AuthenticationError } from '../types/errors.js';
+import { getConfig, CONSTANTS } from '../config/config.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Authentication service
+ */
+export class AuthenticationService {
+    httpClient;
+    tokenCache = null;
+    config = getConfig();
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Get a valid access token, refreshing if necessary
+     */
+    async getAccessToken() {
+        // Check if we have a valid cached token
+        if (this.tokenCache && this.isTokenValid()) {
+            logger.debug('Using cached authentication token');
+            return this.tokenCache.token;
+        }
+        // Token expired or doesn't exist, login again
+        logger.info('Authenticating with Hawkeye API...');
+        return this.login();
+    }
+    /**
+     * Check if the cached token is still valid
+     */
+    isTokenValid() {
+        if (!this.tokenCache) {
+            return false;
+        }
+        // Check if token is expired (with buffer)
+        const now = Date.now();
+        return now < this.tokenCache.expiresAt;
+    }
+    /**
+     * Login and cache the access token
+     */
+    async login() {
+        try {
+            const loginRequest = {
+                email: this.config.email,
+                password: this.config.password,
+            };
+            const response = await this.httpClient.post(CONSTANTS.ENDPOINTS.LOGIN, loginRequest, {
+                timeout: CONSTANTS.TIMEOUTS.AUTH_REQUEST,
+            });
+            const token = response.data.access_token;
+            if (!token) {
+                throw new AuthenticationError('No access_token found in authentication response', { response: response.data }, [
+                    'Check if the Hawkeye API is returning the expected response format',
+                    'Verify API version compatibility',
+                ]);
+            }
+            // Cache the token with 55-minute expiry (5-minute buffer)
+            const expiresAt = Date.now() + (55 * 60 * 1000);
+            this.tokenCache = { token, expiresAt };
+            // Set token in HTTP client for future requests
+            this.httpClient.setAuthToken(token);
+            logger.info('Successfully authenticated with Hawkeye API');
+            return token;
+        }
+        catch (error) {
+            logger.error('Authentication failed', error);
+            if (error instanceof AuthenticationError) {
+                throw error;
+            }
+            throw new AuthenticationError('Failed to authenticate with Hawkeye API', { originalError: error instanceof Error ? error.message : String(error) }, [
+                'Verify HAWKEYE_EMAIL and HAWKEYE_PASSWORD environment variables are correct',
+                'Check if HAWKEYE_BASE_URL is pointing to the correct Hawkeye instance',
+                'Ensure network connectivity to the Hawkeye API',
+            ]);
+        }
+    }
+    /**
+     * Clear the cached token (useful for testing or forced re-authentication)
+     */
+    clearTokenCache() {
+        this.tokenCache = null;
+        this.httpClient.clearAuthToken();
+        logger.debug('Token cache cleared');
+    }
+    /**
+     * Check if user is authenticated (has valid cached token)
+     */
+    isAuthenticated() {
+        return this.isTokenValid();
+    }
+}
+//# sourceMappingURL=auth.service.js.map

package/build/services/auth.service.js.map

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

package/build/services/project.service.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Project management service for Hawkeye API
+ * Handles listing projects, getting project details, and managing default project
+ */
+import { HttpClient } from '../utils/http-client.js';
+import { AuthenticationService } from './auth.service.js';
+import { Project } from '../types/hawkeye.js';
+/**
+ * Project management service
+ */
+export declare class ProjectService {
+    private httpClient;
+    private authService;
+    private config;
+    private projectCache;
+    private defaultProjectUuid;
+    constructor(httpClient: HttpClient, authService: AuthenticationService);
+    /**
+     * List all projects, using cache if available
+     */
+    listProjects(includeInactive?: boolean): Promise<Project[]>;
+    /**
+     * Get a specific project by UUID
+     */
+    getProject(projectUuid: string): Promise<Project>;
+    /**
+     * Get the default project (from config or first active project)
+     */
+    getDefaultProject(): Promise<Project>;
+    /**
+     * Set the default project UUID (for current session)
+     */
+    setDefaultProject(projectUuid: string): void;
+    /**
+     * Get the current default project UUID (if set)
+     */
+    getDefaultProjectUuid(): string | null;
+    /**
+     * Check if project cache is still valid
+     */
+    private isCacheValid;
+    /**
+     * Filter projects by state
+     */
+    private filterProjects;
+    /**
+     * Clear project cache (useful for testing or forced refresh)
+     */
+    clearCache(): void;
+}

package/build/services/project.service.js

@@ -0,0 +1,136 @@
+/**
+ * Project management service for Hawkeye API
+ * Handles listing projects, getting project details, and managing default project
+ */
+import { ApiError } from '../types/errors.js';
+import { getConfig, CONSTANTS } from '../config/config.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Project management service
+ */
+export class ProjectService {
+    httpClient;
+    authService;
+    config = getConfig();
+    projectCache = null;
+    defaultProjectUuid = null;
+    constructor(httpClient, authService) {
+        this.httpClient = httpClient;
+        this.authService = authService;
+        this.defaultProjectUuid = this.config.defaultProjectUuid || null;
+    }
+    /**
+     * List all projects, using cache if available
+     */
+    async listProjects(includeInactive = false) {
+        // Check cache
+        if (this.projectCache && this.isCacheValid()) {
+            logger.debug('Using cached project list');
+            return this.filterProjects(this.projectCache.projects, includeInactive);
+        }
+        // Fetch from API
+        await this.authService.getAccessToken(); // Ensure authenticated
+        try {
+            logger.info('Fetching project list from Hawkeye API');
+            const response = await this.httpClient.get(CONSTANTS.ENDPOINTS.PROJECTS);
+            const projects = response.data.specs || [];
+            // Cache the results
+            this.projectCache = {
+                projects,
+                timestamp: Date.now(),
+            };
+            logger.info(`Found ${projects.length} projects`);
+            return this.filterProjects(projects, includeInactive);
+        }
+        catch (error) {
+            logger.error('Failed to list projects', error);
+            // Re-throw the error as-is to preserve Axios error details
+            throw error;
+        }
+    }
+    /**
+     * Get a specific project by UUID
+     */
+    async getProject(projectUuid) {
+        const projects = await this.listProjects(true); // Include inactive
+        const project = projects.find(p => p.uuid === projectUuid);
+        if (!project) {
+            throw new ApiError(`Project not found: ${projectUuid}`, 404, { projectUuid }, [
+                'Verify the project UUID is correct',
+                'Check if you have access to this project',
+                'Use list_projects tool to see available projects',
+            ]);
+        }
+        return project;
+    }
+    /**
+     * Get the default project (from config or first active project)
+     */
+    async getDefaultProject() {
+        // Use configured default if available
+        if (this.defaultProjectUuid) {
+            try {
+                return await this.getProject(this.defaultProjectUuid);
+            }
+            catch (error) {
+                logger.warn(`Configured default project ${this.defaultProjectUuid} not found, falling back to first project`);
+            }
+        }
+        // Fall back to first active project
+        const projects = await this.listProjects(false);
+        if (projects.length === 0) {
+            throw new ApiError('No active projects found', 404, undefined, [
+                'Create a project in Hawkeye first',
+                'Check if your projects are in active state',
+                'Verify you have access to at least one project',
+            ]);
+        }
+        logger.info(`Using first active project as default: ${projects[0].name}`);
+        return projects[0];
+    }
+    /**
+     * Set the default project UUID (for current session)
+     */
+    setDefaultProject(projectUuid) {
+        this.defaultProjectUuid = projectUuid;
+        logger.info(`Default project set to: ${projectUuid}`);
+    }
+    /**
+     * Get the current default project UUID (if set)
+     */
+    getDefaultProjectUuid() {
+        return this.defaultProjectUuid;
+    }
+    /**
+     * Check if project cache is still valid
+     */
+    isCacheValid() {
+        if (!this.projectCache) {
+            return false;
+        }
+        const now = Date.now();
+        const age = now - this.projectCache.timestamp;
+        return age < this.config.projectCacheTtlMs;
+    }
+    /**
+     * Filter projects by state
+     */
+    filterProjects(projects, includeInactive) {
+        if (includeInactive) {
+            return projects;
+        }
+        // Only return active projects
+        return projects.filter(p => p.state === 'ACTIVE' ||
+            p.state === 'active' ||
+            !p.state // If state is not defined, include it
+        );
+    }
+    /**
+     * Clear project cache (useful for testing or forced refresh)
+     */
+    clearCache() {
+        this.projectCache = null;
+        logger.debug('Project cache cleared');
+    }
+}
+//# sourceMappingURL=project.service.js.map

package/build/services/project.service.js.map

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