aws-helper MCP Server

Instructions

Implementation Reference

• src/index.ts:175-225 (handler)

  The handler function that implements the get_ec2_summary tool. It creates an EC2 client, describes all instances, tallies counts by state (running, stopped, etc.) and by instance type, then returns a formatted markdown summary text.

  async function getEC2Summary(args: any) {
    const region = args?.region || 'ap-northeast-2';
    const client = new EC2Client({ region });
    
    const command = new DescribeInstancesCommand({});
    const response = await client.send(command);
    
    const summary = {
      total: 0,
      running: 0,
      stopped: 0,
      pending: 0,
      terminated: 0,
      byType: {} as Record<string, number>
    };
    
    for (const reservation of response.Reservations || []) {
      for (const instance of reservation.Instances || []) {
        summary.total++;
        
        const state = instance.State?.Name || 'unknown';
        if (state === 'running') summary.running++;
        else if (state === 'stopped') summary.stopped++;
        else if (state === 'pending') summary.pending++;
        else if (state === 'terminated') summary.terminated++;
        
        const type = instance.InstanceType || 'unknown';
        summary.byType[type] = (summary.byType[type] || 0) + 1;
      }
    }
    
    return {
      content: [
        {
          type: 'text',
          text: `📈 EC2 인스턴스 요약 (${region})\n\n` +
                `**상태별 현황:**\n` +
                `• 전체: ${summary.total}개\n` +
                `• 실행 중: ${summary.running}개\n` +
                `• 중지됨: ${summary.stopped}개\n` +
                `• 시작 중: ${summary.pending}개\n` +
                `• 종료됨: ${summary.terminated}개\n\n` +
                `**인스턴스 타입별:**\n` +
                Object.entries(summary.byType)
                  .sort(([,a], [,b]) => b - a)
                  .map(([type, count]) => `• ${type}: ${count}개`)
                  .join('\n')
        }
      ]
    };
  }

• src/index.ts:58-67 (schema)

  The input schema for the get_ec2_summary tool, defining an optional 'region' parameter with default 'ap-northeast-2'.

  inputSchema: {
    type: 'object',
    properties: {
      region: {
        type: 'string',
        description: 'AWS 리전',
        default: 'ap-northeast-2'
      }
    }
  }

• src/index.ts:55-68 (registration)

  Registration of the get_ec2_summary tool in the ListToolsRequest handler response, specifying name, description, and input schema.

  {
    name: 'get_ec2_summary',
    description: 'EC2 인스턴스 요약 정보를 제공합니다',
    inputSchema: {
      type: 'object',
      properties: {
        region: {
          type: 'string',
          description: 'AWS 리전',
          default: 'ap-northeast-2'
        }
      }
    }
  },

• src/index.ts:96-97 (registration)

  Registration/mapping of tool name to handler in the CallToolRequest switch dispatcher.

  case 'get_ec2_summary':
    return await getEC2Summary(args);