analyze_costs
Analyze cloud costs across AWS, Azure, or GCP to identify spending patterns and optimize resource usage based on date ranges and granularity.
Instructions
Analyze cloud costs for AWS, Azure, or GCP
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| provider | Yes | Cloud provider | |
| startDate | Yes | Start date (YYYY-MM-DD) | |
| endDate | Yes | End date (YYYY-MM-DD) | |
| granularity | No | Cost granularity | monthly |
Implementation Reference
- src/tools/cost-analysis.ts:77-121 (handler)Primary handler for cost analysis tools, including the switch case for 'analyze_costs' that delegates to provider-specific functions.export async function handleCostAnalysisTool(name: string, args: unknown): Promise<unknown> { const params = args as Record<string, unknown>; const provider = params.provider as CloudProvider; switch (name) { case 'analyze_costs': { const startDate = params.startDate as string; const endDate = params.endDate as string; const granularity = (params.granularity as string) || 'monthly'; if (provider === 'aws') { return await analyzeAWSCosts(startDate, endDate, granularity); } else if (provider === 'azure') { // Azure cost analysis would go here return { message: 'Azure cost analysis not yet fully implemented' }; } else if (provider === 'gcp') { // GCP cost analysis would go here return { message: 'GCP cost analysis not yet fully implemented' }; } throw new Error(`Unsupported provider: ${provider}`); } case 'get_cost_by_service': { const startDate = params.startDate as string; const endDate = params.endDate as string; if (provider === 'aws') { return await getAWSCostByService(startDate, endDate); } return { message: `Cost by service not yet implemented for ${provider}` }; } case 'estimate_monthly_cost': { // Simplified estimation return { provider, estimatedMonthlyCost: 'N/A - Requires actual usage data', message: 'Monthly cost estimation requires detailed usage metrics', }; } default: throw new Error(`Unknown cost analysis tool: ${name}`); } }
- src/tools/cost-analysis.ts:123-202 (helper)Core helper function implementing AWS cost analysis using AWS Cost Explorer client, processing costs by service and time period.async function analyzeAWSCosts(startDate: string, endDate: string, granularity: string): Promise<string> { try { const credentials = await credentialManager.getCredentials('aws'); if (!credentials) { throw new Error('AWS credentials not found'); } const client = new CostExplorerClient({ region: 'us-east-1', // Cost Explorer is global credentials: credentials.accessKeyId && credentials.secretAccessKey ? { accessKeyId: credentials.accessKeyId, secretAccessKey: credentials.secretAccessKey, } : undefined, }); const command = new GetCostAndUsageCommand({ TimePeriod: { Start: startDate, End: endDate, }, Granularity: granularity === 'daily' ? 'DAILY' : 'MONTHLY', Metrics: ['BlendedCost', 'UnblendedCost'], GroupBy: [{ Type: 'DIMENSION', Key: 'SERVICE' }], }); const response = await client.send(command); const costAnalysis: CostAnalysis = { provider: 'aws', period: { start: new Date(startDate), end: new Date(endDate), }, totalCost: 0, currency: 'USD', breakdown: [], trends: [], }; if (response.ResultsByTime && response.ResultsByTime.length > 0) { for (const result of response.ResultsByTime) { const timePeriod = result.TimePeriod; if (timePeriod && result.Groups) { for (const group of result.Groups) { const cost = parseFloat(group.Metrics?.BlendedCost?.Amount || '0'); costAnalysis.totalCost += cost; const serviceName = group.Keys?.[0] || 'Unknown'; costAnalysis.breakdown.push({ service: serviceName, cost, percentage: 0, // Will calculate after }); if (timePeriod.Start) { costAnalysis.trends?.push({ date: new Date(timePeriod.Start), cost, service: serviceName, }); } } } } // Calculate percentages if (costAnalysis.totalCost > 0) { for (const item of costAnalysis.breakdown) { item.percentage = (item.cost / costAnalysis.totalCost) * 100; } } } return Formatters.formatCostAnalysis(costAnalysis); } catch (error) { throw new Error(`Failed to analyze AWS costs: ${error instanceof Error ? error.message : String(error)}`); } }
- src/tools/cost-analysis.ts:8-36 (schema)Tool definition including name, description, and input schema for 'analyze_costs'.{ name: 'analyze_costs', description: 'Analyze cloud costs for AWS, Azure, or GCP', inputSchema: { type: 'object', properties: { provider: { type: 'string', enum: ['aws', 'azure', 'gcp'], description: 'Cloud provider', }, startDate: { type: 'string', description: 'Start date (YYYY-MM-DD)', }, endDate: { type: 'string', description: 'End date (YYYY-MM-DD)', }, granularity: { type: 'string', enum: ['daily', 'monthly'], description: 'Cost granularity', default: 'monthly', }, }, required: ['provider', 'startDate', 'endDate'], }, },
- src/server.ts:19-27 (registration)Registers costAnalysisTools (including analyze_costs) into the global allTools array used for listing available MCP tools.const allTools = [ ...awsTools, ...azureTools, ...gcpTools, ...resourceManagementTools, ...costAnalysisTools, ...monitoringTools, ...securityTools, ];
- src/server.ts:72-73 (registration)Dispatch logic in MCP server that routes calls to 'analyze_costs' (and other cost tools) to the appropriate handler.} else if (costAnalysisTools.some((t) => t.name === name)) { result = await handleCostAnalysisTool(name, args || {});