What is Aws Cli Mcp Server

aws-cli-mcp-server is an MCP (Model Context Protocol) server that allows users to generate and execute AWS CLI commands directly from Claude, facilitating seamless interaction with AWS services.

Use cases

Use cases include listing S3 buckets, creating new S3 buckets, and retrieving details about EC2 services, making it suitable for developers and system administrators managing AWS resources.

How to use

To use aws-cli-mcp-server, clone the repository, install dependencies, build the project, configure AWS CLI credentials, and start the server. Integration with Claude Desktop requires updating the configuration file to include the MCP server.

Key features

Key features include executing AWS CLI commands through the MCP protocol, retrieving detailed information about AWS services, listing available AWS services, and providing full access to AWS CLI capabilities.

Where to use

aws-cli-mcp-server can be used in cloud computing environments, DevOps practices, and any application that requires interaction with AWS services through command-line operations.

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

1. Clone this repository:

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

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Ensure AWS CLI is configured:

aws configure

5. 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