aws-mcp

npmGitHub
  • Cloud Platforms
  • OS Automation
TypeScript
21
A
security – no known vulnerabilities (report Issue)
F
license - not found
A
quality - confirmed to work

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with your AWS environment. This allows for natural language querying and management of your AWS resources during conversations. Think of better Amazon Q alternative.

  1. Tools
  2. Prompts
  3. Resources
  4. Server Configuration
  5. README.md

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
run-aws-codeRun AWS code
list-credentialsList all AWS credentials/configs/profiles that are configured/usable on this machine
select-profileSelects AWS profile to use for subsequent interactions. If needed, does SSO authentication

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Need Help?View Source CodeReport Issue
README.md

AWS MCP

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with your AWS environment. This allows for natural language querying and management of your AWS resources during conversations. Think of better Amazon Q alternative.

AWS MCP

Features

  • 🔍 Query and modify AWS resources using natural language
  • ☁️ Support for multiple AWS profiles and SSO authentication
  • 🌐 Multi-region support
  • 🔐 Secure credential handling (no credentials are exposed to external services, your local credentials are used)
  • 🏃‍♂️ Local execution with your AWS credentials

Prerequisites

Installation

  1. Clone the repository:
git clone https://github.com/RafalWilinski/aws-mcp cd aws-mcp
  1. Install dependencies:
pnpm install # or npm install

Usage

  1. Open Claude desktop app and go to Settings -> Developer -> Edit Config

Claude Settings

  1. Add the following entry to your claude_desktop_config.json:
{ "mcpServers": { "aws": { "command": "npm", "args": ["--prefix", "/Users/<YOUR USERNAME>/aws-mcp", "start"] } } }

Important: Replace /Users/<YOUR USERNAME>/aws-mcp with the actual path to your project directory.

  1. Restart Claude desktop app. You should see this:

Claude MCP Connection Status

  1. Start by selecting an AWS profile or jump to action by asking:
    • "List available AWS profiles"
    • "List all EC2 instances in my account"
    • "Show me S3 buckets with their sizes"
    • "What Lambda functions are deployed in us-east-1?"
    • "List all ECS clusters and their services"

Troubleshooting

To see logs:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-aws.log # or tail -n 50 -f ~/Library/Logs/Claude/mcp.log

Features in Development

  • MFA support
  • Cache SSO credentials to prevent from refreshing them too eagerly

<a href="https://glama.ai/mcp/servers/ta7kdy57us"><img width="380" height="200" src="https://glama.ai/mcp/servers/ta7kdy57us/badge" alt="aws-mcp MCP server" /></a>

GitHub Badge

Glama performs regular codebase and documentation scans to:

  • Confirm that the MCP server is working as expected.
  • Confirm that there are no obvious security issues with dependencies of the server.
  • Extract server characteristics such as tools, resources, prompts, and required parameters.

Our directory badge helps users to quickly asses that the MCP server is safe, server capabilities, and instructions for installing the server.

Copy the following code to your README.md file: