Skip to content
Back to search

cloud-mcp-server

A lightweight service that enables AI assistants to execute AWS CLI commands (in safe containerized environment) through the Model Context Protocol (MCP). Bridges Claude, Cursor, and other MCP-aware AI tools with AWS CLI for enhanced cloud infrastructure management.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alexei-led--cloud-mcp-server/badge.svg)](/listings/alexei-led--cloud-mcp-server)

HTML

<a href="/listings/alexei-led--cloud-mcp-server"><img src="/api/listings/alexei-led--cloud-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) installed - AWS credentials configured (see [AWS Credentials](#aws-credentials)) - [uv](https://docs.astral.sh/uv/getting-started/installation/) installed (for `uvx`)

Claude Code

Add to your MCP settings (Cmd+Shift+P → "Claude: Open MCP Config"):

{
  "mcpServers": {
    "aws": {
      "command": "uvx",
      "args": ["aws-mcp"]
    }
  }
}

Claude Desktop

Add to your Claude Desktop config file:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

{
  "mcpServers": {
    "aws": {
      "command": "uvx",
      "args": ["aws-mcp"]
    }
  }
}

Docker (More Secure)

Docker provides stronger isolation by running commands in a container:

{
  "mcpServers": {
    "aws": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "~/.aws:/home/appuser/.aws:ro",
        "ghcr.io/alexei-led/aws-mcp-server:latest"
      ]
    }
  }
}

> **Note**: Replace `~/.aws` with the full path on Windows (e.g., `C:\Users\YOU\.aws`).

Docker with Streamable HTTP Transport

For web-based MCP clients, use the `streamable-http` transport:

docker run --rm -p 8000:8000 \
  -e AWS_MCP_TRANSPORT=streamable-http \
  -v ~/.aws:/home/appuser/.aws:ro \
  ghcr.io/alexei-led/aws-mcp-server:latest

The server will be available at `http://localhost:8000/mcp`.

> **Note**: The `sse` transport is deprecated. Use `streamable-http` instead.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 188 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # AWS MCP Server
  2. [![CI](https://github.com/alexei-led/aws-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/alexei-led/aws-mcp-server/actions/workflows/ci.yml)
  3. [![PyPI](https://img.shields.io/pypi/v/aws-mcp)](https://pypi.org/project/aws-mcp/)
  4. [![Code Coverage](https://codecov.io/gh/alexei-led/aws-mcp-server/branch/main/graph/badge.svg?token=K8vdP3zyuy)](https://codecov.io/gh/alexei-led/aws-mcp-server)
  5. [![Linter: Ruff](https://img.shields.io/badge/Linter-Ruff-brightgreen?style=flat-square)](https://github.com/alexei-led/aws-mcp-server)
  6. [![Docker Image](https://img.shields.io/badge/ghcr.io-aws--mcp--server-blue?logo=docker)](https://github.com/alexei-led/aws-mcp-server/pkgs/container/aws-mcp-server)
  7. Give Claude access to all 200+ AWS services through the AWS CLI.
  8. ## Demo
  9. [Demo](https://private-user-images.githubusercontent.com/1898375/424996801-b51ddc8e-5df5-40c4-8509-84c1a7800d62.mp4?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NDI0NzY5OTUsIm5iZiI6MTc0MjQ3NjY5NSwicGF0aCI6Ii8xODk4Mzc1LzQyNDk5NjgwMS1iNTFkZGM4ZS01ZGY1LTQwYzQtODUwOS04NGMxYTc4MDBkNjIubXA0P1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI1MDMyMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNTAzMjBUMTMxODE1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NjgwNTM4MDVjN2U4YjQzN2Y2N2Y5MGVkMThiZTgxYWEyNzBhZTlhMTRjZDY3ZDJmMzJkNmViM2U4M2U4MTEzNSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.tIb7uSkDpSaspIluzCliHS8ATmlzkvEnF3CiClD-UGQ)
  10. ## What It Does
  11. This MCP server lets Claude run AWS CLI commands on your behalf. Instead of wrapping each AWS API individually, it wraps the CLI itself—giving Claude complete AWS access through just two tools:
  12. | Tool | Purpose |
  13. | ------------------ | ----------------------------------------------------------------- |
  14. | `aws_cli_help` | Get documentation for any AWS command |
  15. | `aws_cli_pipeline` | Execute AWS CLI commands with optional pipes (`jq`, `grep`, etc.) |
  16. Claude learns commands on-demand using `--help`, then executes them. Your IAM policy controls what it can actually do.
  17. ```mermaid
  18. flowchart LR
  19. Claude[Claude] -->|MCP| Server[AWS MCP Server]
  20. Server --> CLI[AWS CLI]
  21. CLI --> AWS[AWS Cloud]
  22. IAM[Your IAM Policy] -.->|controls| AWS
  23. ```
  24. ## What's New
  25. - **Streamable HTTP transport** — New `streamable-http` transport for web-based MCP clients, replacing the deprecated `sse` transport ([#33](https://github.com/alexei-led/aws-mcp-server/issues/33))
  26. - **Input validation error handling** — Validation errors now return proper MCP tool errors (`isError: true`) instead of regular results ([#34](https://github.com/alexei-led/aws-mcp-server/issues/34))
  27. - **Server description** — Server advertises its purpose to MCP clients via the `instructions` field ([#35](https://github.com/alexei-led/aws-mcp-server/issues/35))
  28. - **Server icons** — Server provides icon metadata for MCP client display ([#36](https://github.com/alexei-led/aws-mcp-server/issues/36))
  29. - **Graceful shutdown** — Server disconnects cleanly when the MCP client disconnects ([#16](https://github.com/alexei-led/aws-mcp-server/issues/16))
  30. ## Quick Start
  31. ### Prerequisites
  32. - [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) installed
  33. - AWS credentials configured (see [AWS Credentials](#aws-credentials))
  34. - [uv](https://docs.astral.sh/uv/getting-started/installation/) installed (for `uvx`)
  35. ### Claude Code
  36. Add to your MCP settings (Cmd+Shift+P → "Claude: Open MCP Config"):
  37. ```json
  38. {
  39. "mcpServers": {
  40. "aws": {
  41. "command": "uvx",
  42. "args": ["aws-mcp"]
  43. }
  44. }
  45. }
  46. ```
  47. ### Claude Desktop
  48. Add to your Claude Desktop config file:
  49. **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
  50. **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
  51. ```json
  52. {
  53. "mcpServers": {
  54. "aws": {
  55. "command": "uvx",
  56. "args": ["aws-mcp"]
  57. }
  58. }
  59. }
  60. ```
  61. ### Docker (More Secure)
  62. Docker provides stronger isolation by running commands in a container:
  63. ```json
  64. {
  65. "mcpServers": {
  66. "aws": {
  67. "command": "docker",
  68. "args": [
  69. "run",
  70. "-i",
  71. "--rm",
  72. "-v",
  73. "~/.aws:/home/appuser/.aws:ro",
  74. "ghcr.io/alexei-led/aws-mcp-server:latest"
  75. ]
  76. }
  77. }
  78. }
  79. ```
  80. > **Note**: Replace `~/.aws` with the full path on Windows (e.g., `C:\Users\YOU\.aws`).
  81. ### Docker with Streamable HTTP Transport
  82. For web-based MCP clients, use the `streamable-http` transport:
  83. ```bash
  84. docker run --rm -p 8000:8000 \
  85. -e AWS_MCP_TRANSPORT=streamable-http \
  86. -v ~/.aws:/home/appuser/.aws:ro \
  87. ghcr.io/alexei-led/aws-mcp-server:latest
  88. ```
  89. The server will be available at `http://localhost:8000/mcp`.
  90. > **Note**: The `sse` transport is deprecated. Use `streamable-http` instead.
  91. ## AWS Credentials
  92. The server uses the standard AWS credential chain. Your credentials are discovered automatically from:
  93. 1. **Environment variables**: `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`
  94. 2. **Credentials file**: `~/.aws/credentials`
  95. 3. **Config file**: `~/.aws/config` (for profiles and region)
  96. 4. **IAM role**: When running on EC2, ECS, or Lambda
  97. To use a specific profile:
  98. ```json
  99. {
  100. "mcpServers": {
  101. "aws": {
  102. "command": "uvx",
  103. "args": ["aws-mcp"],
  104. "env": {
  105. "AWS_PROFILE": "my-profile"
  106. }
  107. }
  108. }
  109. }
  110. ```
  111. ## Configuration
  112. ### AWS Settings
  113. | Environment Variable | Description | Default |
  114. | ----------------------------- | ---------------------------------------------- | -------------------- |
  115. | `AWS_PROFILE` | AWS profile to use | `default` |
  116. | `AWS_REGION` | AWS region (also accepts `AWS_DEFAULT_REGION`) | `us-east-1` |
  117. | `AWS_CONFIG_FILE` | Custom path to AWS config file | `~/.aws/config` |
  118. | `AWS_SHARED_CREDENTIALS_FILE` | Custom path to credentials file | `~/.aws/credentials` |
  119. ### Server Settings
  120. | Environment Variable | Description | Default |
  121. | ----------------------------- | ------------------------------------------------ | -------- |
  122. | `AWS_MCP_TIMEOUT` | Command execution timeout in seconds | `300` |
  123. | `AWS_MCP_MAX_OUTPUT` | Maximum output size in characters | `100000` |
  124. | `AWS_MCP_TRANSPORT` | Transport protocol (`stdio`, `sse`, or `streamable-http`) | `stdio` |
  125. | `AWS_MCP_SANDBOX` | Sandbox mode (`auto`, `disabled`, `required`) | `auto` |
  126. | `AWS_MCP_SANDBOX_CREDENTIALS` | Credential passing (`env`, `aws_config`, `both`) | `both` |
  127. ## Security
  128. **Your IAM policy is your security boundary.** This server executes whatever AWS commands Claude requests—IAM controls what actually succeeds.
  129. Best practices:
  130. - Use a **least-privilege IAM role** (only permissions Claude needs)
  131. - **Never use root credentials**
  132. - Consider **Docker** for additional host isolation
  133. For detailed security architecture, see [Security Documentation](docs/SECURITY.md).
  134. ## Documentation
  135. - [Usage Guide](docs/USAGE.md) — Tools, resources, and prompt templates
  136. - [Security Architecture](docs/SECURITY.md) — IAM + Sandbox + Docker model
  137. - [Development Guide](docs/DEVELOPMENT.md) — Contributing and testing
  138. ## License
  139. MIT License — see [LICENSE](LICENSE) for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.