use_aws_mcp

use_aws_mcp

amazon-q-cli's use_aws tool extracted into independent mcp, for general aws api usage.

2
Stars
0
Forks
0
Releases

Overview

use_aws_mcp is a standalone MCP server that provides AWS CLI functionality through a standardized interface. It replicates the functionality of the use_aws tool from amazon-q-cli, exposing a single MCP tool named use_aws. The server accepts service_name, operation_name, parameters, region, profile_name, and label, and executes AWS CLI commands with proper parameter handling. It includes safety features that detect read-only vs. write operations and truncates large outputs to a maximum of 100KB. It manages the AWS CLI user agent for tracking and automatically formats parameters to kebab-case for CLI compatibility. The server communicates via stdin/stdout using JSON-RPC, enabling integration with MCP clients such as Avante, MCPHub in Neovim, and Cursor. It is fully MCP protocol compliant and provides human-readable command descriptions. Prerequisites include Rust 1.70+, Cargo, AWS CLI installed and configured, and AWS credentials. Build with cargo build --release and run with ./target/release/use_aws_mcp. The README references a description_demo example to illustrate command descriptions.

Details

Owner
runjivu
Language
Rust
License
Apache License 2.0
Updated
2025-12-07

Features

AWS CLI Integration

Execute AWS CLI commands with proper parameter handling

Safety Checks

Automatic detection of read-only vs. write operations

User Agent Management

Proper AWS CLI user agent setup for tracking

Parameter Formatting

Automatic conversion of parameters to kebab-case for CLI compatibility

Error Handling

Comprehensive error handling and output formatting

MCP Protocol

Full Model Context Protocol compliance

Human-Readable Descriptions

Rich command descriptions using terminal formatting

Audience

DevelopersUse across MCP-enabled tools to execute AWS CLI commands via a standardized interface.
MCP clientsConfigure MCP clients (e.g., Avante, MCPHub, Cursor) to connect to use_aws_mcp and manage AWS credentials.
AWS teamsRun AWS operations through MCP with safety checks and readable command descriptions.

Tags

MCPAWS CLIRustJSON-RPCAWSSafetyParameter FormattingRead-Only Detection