aws-cli-assistant-lite 1.0.1

Natural language to AWS CLI converter with real-time validation

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 <https://github.com/MaliniAgrawal/aws-cli-assistant-lite.git>
cd aws-cli-assistant-lite

2. Install dependencies

pip install -r requirements.txt

3. Configure AWS credentials

aws configure

4. Start the MCP server

python mcp_server.py

5. Connect to Claude Desktop (if using MCP) Add to your claude_desktop_config.json(given exaple below is my path in python evn):

{
  "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

• Email: [e-mail]
• Documentation: https://docs.yourdomain.com
• Issues: https://github.com/yourrepo/issues

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!# pip install aws-cli-assistant-lite