Skip to main content

Natural language to AWS CLI converter with real-time validation

Project description

AWS CLI Assistant - Lite Edition

Overview

AWS CLI Assistant converts your natural language requests into proper AWS CLI commands with real-time validation against your AWS environment.

Features

Natural Language Processing - Just describe what you want to do
5 AWS Services - S3, DynamoDB, EC2, Lambda, IAM
Real-time Validation - Commands tested against your actual AWS account
Instant Results - Get command syntax and execution results immediately

Supported Operations

S3 Operations

  • List buckets
  • Create buckets
  • Delete buckets
  • List objects in bucket

DynamoDB Operations

  • List tables
  • Describe table
  • Query table
  • Scan table

EC2 Operations

  • List instances
  • Describe instances
  • Start/stop instances

Lambda Operations

  • List functions
  • Invoke function
  • Get function configuration

IAM Operations

  • List users
  • List roles
  • Get user details

Installation

Prerequisites

  • Python 3.10 or higher
  • AWS CLI configured with credentials
  • Valid AWS account

Quick Start

  1. Clone or download the package
git clone <your-repo-url>
cd aws-cli-assistant-lite
  1. Install dependencies
pip install -r requirements.txt
  1. Configure AWS credentials
aws configure
  1. Start the MCP server
python mcp_server.py
  1. Connect to Claude Desktop (if using MCP) Add to your claude_desktop_config.json:
{
  "mcpServers": {
    "aws-cli-assistant-lite": {
      "command": "C:/myworkspace/mcp/MCP-phase-1/venv-phase-1/Scripts/python.exe",
      "args": [
        "C:/myworkspace/mcp/MCP-phase-1/src/mcp_server.py"
      ],
      "env": {
        "AWS_REGION": "us-west-1",
        "PYTHONPATH": "C:/myworkspace/mcp/MCP-phase-1/src",
        "PYTHONUNBUFFERED": "1"
      }
      }
  }
}
                                                    

Usage Examples

Example 1: List S3 Buckets

Input: "list all my s3 buckets"
Output:

aws s3 ls

Validation: ✅ Valid - Found 19 buckets

Example 2: List Lambda Functions

Input: "show me lambda functions"
Output:

aws lambda list-functions --region us-west-1

Validation: ✅ Valid - Found 11 functions

Example 3: List DynamoDB Tables

Input: "list dynamodb tables"
Output:

aws dynamodb list-tables

Validation: ✅ Valid - Found 4 tables

Architecture

User Input (Natural Language)
    ↓
NLP Transformer Model
    ↓
AWS CLI Command Generation
    ↓
Boto3 Validation (Real AWS)
    ↓
Result + Validation Status

API Reference

generate_aws_cli(query: str)

Converts natural language to AWS CLI command

Parameters:

  • query (string): Natural language request

Returns:

{
  "command": "aws s3 ls",
  "explanation": "Lists S3 buckets in your account",
  "validation": {
    "intent": "list_s3_buckets",
    "region": "us-west-1",
    "status": "valid",
    "reason": "Listed buckets",
    "detail": { "buckets": [...] }
  }
}

health_check()

Verifies service status

Returns:

{
  "status": "ok",
  "model": "local-transformer"
}

list_supported_services()

Returns supported AWS services

Returns:

["s3", "dynamodb", "ec2", "lambda", "iam"]

Configuration

Environment Variables

AWS_REGION=us-west-1          # Your preferred AWS region
AWS_PROFILE=default           # AWS profile to use
MCP_PORT=3000                 # Server port (optional)

Custom Settings

Edit config.yaml:

services:
  - s3
  - dynamodb
  - ec2
  - lambda
  - iam

validation:
  enabled: true
  timeout: 30

model:
  type: local-transformer
  cache_size: 1000

Pricing

Lite Edition: $49/month or $500 one-time purchase

Includes:

  • 5 AWS services
  • 100 queries per day
  • Email support
  • Monthly updates

Need more? Contact us about Pro Edition (15+ services, unlimited queries)

Support

FAQ

Q: Does this work with all AWS regions?
A: Yes, specify your region in AWS configuration.

Q: Can I use this with multiple AWS accounts?
A: Lite edition supports one account. Pro edition supports multiple.

Q: Is my AWS data secure?
A: Yes, all processing is local. We never store your AWS credentials or data.

Q: What happens if I exceed 100 queries/day?
A: Service pauses until next day. Upgrade to Pro for unlimited queries.

Roadmap

Coming in Q1 2026:

  • RDS support
  • CloudFormation support
  • Cost estimation
  • Batch operations

License

Commercial License - See LICENSE.txt

About

Created by [Malini Agrawal] - AWS Certified Solutions Architect & Developer
Transitioned from Banking & Finance to AWS Cloud Engineering in 2021


Ready to simplify your AWS CLI experience?
Download and get started today!#\x00 \x00a\x00w\x00s\x00-\x00c\x00l\x00i\x00-\x00a\x00s\x00s\x00i\x00s\x00t\x00a\x00n\x00t\x00-\x00l\x00i\x00t\x00e\x00 \x00 \x00

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aws_cli_assistant_lite-1.0.0.tar.gz (22.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aws_cli_assistant_lite-1.0.0-py3-none-any.whl (26.3 kB view details)

Uploaded Python 3

File details

Details for the file aws_cli_assistant_lite-1.0.0.tar.gz.

File metadata

  • Download URL: aws_cli_assistant_lite-1.0.0.tar.gz
  • Upload date:
  • Size: 22.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.2

File hashes

Hashes for aws_cli_assistant_lite-1.0.0.tar.gz
Algorithm Hash digest
SHA256 671c69fb1696908488db6e84b1a171a2ea7ac9339944dfd409d40930c272c5ce
MD5 4000b99528a9ad4aeb7094e7579310a7
BLAKE2b-256 4394a6b581c9cc11883a14989506a15a29393621ec539baa102bcfc988d52bb6

See more details on using hashes here.

File details

Details for the file aws_cli_assistant_lite-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for aws_cli_assistant_lite-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 221914881745945e23464bb5e7ddab8d6fcf503ae2248c9773ab0e5bd2ec7333
MD5 37f6face53d7f9925fc23a4fae45c058
BLAKE2b-256 9969bfc737675fe73813c9d443ab17db617acecd790447868171820ecfd4ede1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page