Aws Cli MCP Server

🚀 AWS CLI MCP Server

A server implemented via the Model Context Protocol (MCP) that allows you to generate and execute AWS CLI commands directly from Claude.

🚀 Quick Start

The AWS CLI MCP Server enables you to generate and execute AWS CLI commands directly from Claude through the MCP protocol.

✨ Features

• Execute AWS CLI commands via the MCP protocol.
• Retrieve detailed information about AWS services.
• List available AWS services.
• Enjoy full access to the capabilities of the AWS CLI.

📦 Installation

Prerequisites

• Node.js (version v20 or higher recommended).
• npm or yarn.
• AWS CLI installed and configured with its 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 the AWS CLI is configured:

aws configure

5. Start the MCP server:

npm start

Integration with Claude Desktop

Add the following 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"
      ]
    }
  }
}

💻 Usage Examples

Basic Usage

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 are the available EC2 commands?

📚 Documentation

Tools

• execute-aws-command: Execute an AWS CLI command.

  • Parameters:
    • command: An AWS service (e.g., s3, ec2, lambda).
    • subcommand (optional): The command to execute (e.g., ls, describe-instances).
    • options (optional): Command options as key - value pairs.

• get-service-details: Get detailed information about a specific AWS service.

  • Parameters:
    • service: The name of an AWS service (e.g., s3, ec2, lambda).

Resources

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

⚠️ Important Note

• This server executes AWS CLI commands with the same permissions as your configuration file.
• Be cautious about who can access this server.
• Consider implementing additional authentication in a production environment.

📄 License

This project is licensed under the MIT License.