aws_list_ec2_instances
Retrieve and display all Amazon EC2 instances in a specified AWS region to monitor and manage cloud infrastructure resources.
Instructions
List all EC2 instances in AWS
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | AWS region | us-east-1 |
Implementation Reference
- src/tools/aws-tools.ts:105-119 (handler)Tool handler logic: invokes AWSAdapter.listEC2Instances(), maps instances to simplified response format with total count and instance details.
case 'aws_list_ec2_instances': { const instances = await adapter.listEC2Instances(); return { total: instances.length, instances: instances.map((inst) => ({ id: inst.id, name: inst.name, type: inst.instanceType, status: inst.status, privateIp: inst.privateIp, publicIp: inst.publicIp, region: inst.region, })), }; } - src/adapters/aws-adapter.ts:69-101 (helper)Core AWS SDK implementation: initializes EC2 client with credentials, sends DescribeInstancesCommand, processes reservations and instances, maps AWS data to EC2Instance objects using helpers.
async listEC2Instances(): Promise<EC2Instance[]> { await this.initializeClients(); if (!this.ec2Client) throw new Error('EC2 client not initialized'); try { const command = new DescribeInstancesCommand({}); const response = await this.ec2Client.send(command); const instances: EC2Instance[] = []; for (const reservation of response.Reservations || []) { for (const instance of reservation.Instances || []) { instances.push({ id: instance.InstanceId || '', type: 'instance', name: this.getInstanceName(instance.Tags), region: this.region, status: this.mapInstanceState(instance.State?.Name), instanceType: instance.InstanceType || '', imageId: instance.ImageId || '', privateIp: instance.PrivateIpAddress, publicIp: instance.PublicIpAddress, launchTime: instance.LaunchTime, tags: this.extractTags(instance.Tags), }); } } return instances; } catch (error) { throw new Error(`Failed to list EC2 instances: ${error instanceof Error ? error.message : String(error)}`); } } - src/tools/aws-tools.ts:5-18 (schema)Tool definition including name, description, and input schema for optional AWS region parameter.
{ name: 'aws_list_ec2_instances', description: 'List all EC2 instances in AWS', inputSchema: { type: 'object', properties: { region: { type: 'string', description: 'AWS region', default: 'us-east-1', }, }, }, }, - src/server.ts:19-27 (registration)Registers the awsTools (including aws_list_ec2_instances) by spreading into the full allTools list provided to MCP server.
const allTools = [ ...awsTools, ...azureTools, ...gcpTools, ...resourceManagementTools, ...costAnalysisTools, ...monitoringTools, ...securityTools, ]; - src/server.ts:64-65 (registration)Routes tool calls matching awsTools to the handleAWSTool dispatcher.
if (awsTools.some((t) => t.name === name)) { result = await handleAWSTool(name, args || {});