A Python Model Context Protocol (MCP) server that lets MCP-compatible clients inspect and operate AWS through the AWS CLI. It supports command execution with validation, command suggestions, AWS region lookup, and caller identity checks.
Features
Execute AWS CLI commands without shell expansion, preserving quoted arguments with shell-style parsing
Python MCP server for AWS CLI inspection and operations
Suggest common AWS CLI commands from natural language requests
Return available AWS regions
Return the current caller identity
Support stdio transport for local MCP clients
Validate configuration and write logs to stderr plus a local log file
Safety Model
This server can execute AWS CLI commands using the credentials available to the process. It blocks shell operators by using subprocess.run(..., shell=False) and flags destructive-looking commands, but it cannot replace IAM least privilege or human review. Use scoped AWS profiles or roles, prefer non-production accounts for testing, and keep destructive commands on manual approval in your MCP client.
Before running this server, install the AWS CLI using the official AWS CLI install guide, then configure credentials using the official AWS CLI sign-in guide and AWS CLI configuration guide. AWS recommends short-term credentials where possible; avoid long-term IAM user keys unless your use case requires them.
Copy the example environment file and adjust values as needed.
cp .env.example .env
Variable
Description
Default
AWS_REGION
Default AWS region
us-east-1
AWS_PROFILE
AWS credentials profile
default
AWS_MCP_WORKING_DIR
Working directory for file operations
/tmp/aws-mcp-work
AWS_MCP_REQUIRE_CONFIRMATION
Emit warnings for destructive-looking operations
true
AWS_MCP_LOG_LEVEL
Application log level
INFO
Running
mdev-aws-mcp-server
From a local checkout before PyPI publication, run:
python -m aws_mcp_server.server
MCP Client Configuration
For published installs, prefer uvx. MCP servers using stdio must write protocol messages only to stdout; this server writes logs to stderr and a local file under ~/.aws-mcp-server/logs.
Claude Desktop / Cursor / Windsurf / Cline
Most MCP clients accept this mcpServers JSON shape:
The mcp-name marker at the top of this README is required for MCP Registry ownership verification. Users should prefer uvx mdev-aws-mcp-server in local MCP client configurations.
Security Notes
Do not commit .env, AWS credentials, profiles, access keys, or account-specific outputs.
Use least-privilege IAM permissions for the profile or role running this server.
Keep call_aws on explicit manual approval in your MCP client.
Do not expose this server over a network without adding authentication, TLS, and network controls.
Review generated command suggestions before executing them.