AWS EC2 MCP Server

A simple MCP server to get AWS EC2 instance information for AI assistants.

Quick Start

1. Install via NPM

npx @quorum-us/aws-ec2-mcp

2. Add to Augment

Add this to your Augment MCP configuration:

{
  "mcpServers": {
    "aws-ec2": {
      "command": "npx",
      "args": ["-y", "@quorum-us/aws-ec2-mcp"],
      "env": {
        "AWS_PROFILE": "your-profile-name"
      }
    }
  }
}

3. AWS Setup

Make sure you have AWS credentials configured:

• Option 1: Set AWS_PROFILE environment variable
• Option 2: Use default AWS credentials (~/.aws/credentials)
• Option 3: Set environment variables:

  export AWS_ACCESS_KEY_ID=your_key
  export AWS_SECRET_ACCESS_KEY=your_secret

Available Tool

get-aws-ec2-instances

Get EC2 instances with filtering options.

Parameters:

• region (required): AWS region (e.g., 'us-east-1')
• profile (optional): AWS profile name
• state (optional): Filter by state - 'running', 'stopped', 'all', etc. (default: 'all')
• includeTerminated (optional): Include terminated instances (default: false)
• instanceIds (optional): Filter by specific instance IDs
• instanceTypes (optional): Filter by instance types (e.g., ['t3.micro'])
• tags (optional): Filter by tags (key-value pairs)

Example Response

{
  "success": true,
  "region": "us-east-1",
  "instanceCount": 1,
  "instances": [
    {
      "instanceId": "i-1234567890abcdef0",
      "instanceType": "t3.micro",
      "state": { "name": "running" },
      "publicIpAddress": "203.0.113.12",
      "privateIpAddress": "10.0.1.15",
      "tags": {
        "Name": "Web Server",
        "Environment": "Production"
      }
    }
  ]
}

Publishing to NPM

For Developers

1. Login to NPM (first time only):

   npm login

2. Update version:

   npm version patch  # for bug fixes
   npm version minor  # for new features
   npm version major  # for breaking changes

3. Build and publish:

   npm run build
   npm publish --access public

4. Test the published package:

   npx @quorum-us/aws-ec2-mcp

Publishing Checklist

• [ ] Update version in package.json
• [ ] Update README if needed
• [ ] Build passes (npm run build)
• [ ] Test locally
• [ ] Publish to NPM
• [ ] Test published package with npx

Development Setup

git clone <repository>
cd aws-ec2-mcp
npm install
npm run build

License

Proprietary - All rights reserved by Quorum US