AWS CLI MCP Server

An MCP (Model Context Protocol) server that lets you generate and execute AWS CLI commands directly from Claude.

Features

Execute AWS CLI commands through the MCP protocol
Get detailed information about AWS services
List available AWS services
Full access to AWS CLI capabilities

Tools

execute-aws-command: Execute AWS CLI commands
- Parameters:
  - command: AWS service (e.g., s3, ec2, lambda)
  - subcommand (optional): Command to execute (e.g., ls, describe-instances)
  - options (optional): Command options as key-value pairs
get-service-details: Get details about a specific AWS service
- Parameters:
  - service: AWS service name (e.g., s3, ec2, lambda)

Resources

aws-services://list: List available AWS services

Setup and Installation

Prerequisites

Node.js (v20 or later recommended)
npm or yarn
AWS CLI installed and configured with credentials
TypeScript

Local Installation

Clone this repository:

git clone https://github.com/IcyKallen/aws-cli-mcp-server
cd aws-cli-mcp-server

Install dependencies:

npm install

Build the project:

npm run build

Ensure AWS CLI is configured:

aws configure

Start the MCP server:

npm start

Integration with Claude Desktop

Add this to your claude_desktop_config.json:

After building the project, you can use:

{
  "mcpServers": {
    "aws-cli": {
      "command": "node",
      "args": [
        "/path/to/aws-cli-mcp-server/dist/index.js"
      ]
    }
  }
}

Example Usage in Claude

List S3 Buckets

I need to list my S3 buckets.

Create an S3 Bucket

Create a new S3 bucket named "my-test-bucket" in the us-west-2 region.

Get EC2 Service Details

What EC2 commands are available?

Security Notes

This server executes AWS CLI commands with the same permissions as your configured AWS credentials
Be careful about who can access this server
Consider implementing additional authentication for production use

License

MIT License