sometrend-mcp-server/src/types/tools.ts

TM2 기반의 썸트렌드(sometrend) MCP 서버 - 트렌드 분석 및 데이터 처리

/**
 * 도구 관련 타입 정의
 */

export interface ToolArgument {
    name: string;
    description: string;
    type: string;
    required: boolean;
    default?: any;
    enum?: string[];
    items?: {
        type: string;
    };
}

export interface ToolDefinition {
    name: string;
    description: string;
    inputSchema: {
        type: string;
        properties: Record<string, any>;
        required: string[];
    };
}

export interface ToolCategory {
    name: string;
    description: string;
    tools: ToolDefinition[];
}

// 도구 통계 타입
export interface ToolStatistics {
    total: number;
    byCategory: Array<{
        name: string;
        count: number;
    }>;
    totalParameters: number;
    requiredParameters: number;
}

// 도구 관련 상수 타입
export interface ToolConstants {
    readonly MAX_RESULTS_LIMIT: number;
    readonly DEFAULT_PAGE_SIZE: number;
    readonly SUPPORTED_DATE_FORMATS: readonly string[];
    readonly SUPPORTED_CHANNELS: readonly string[];
    readonly ANALYSIS_PERIOD: readonly string[];
    readonly SENTIMENT_LEVELS: readonly string[];
}

// 도구 실행 결과 타입
export interface ToolExecutionResult {
    success: boolean;
    data?: any;
    error?: string;
    timestamp: string;
    executionTime?: number;
}

// API 엔드포인트 매핑 타입
export interface ApiEndpointMapping {
    [toolName: string]: {
        endpoint: string;
        method: 'GET' | 'POST' | 'PUT' | 'DELETE';
        baseUrl?: string;
        requiresAuth?: boolean;
    };
}