AWS MCP

AWS MCP is a Model Context Protocol (MCP) server designed to enable AI assistants like Claude to interact with your AWS environment, facilitating natural language querying and management of AWS resources. It serves as an alternative to Amazon Q.

Features

• Query and modify AWS resources using natural language.
• Supports multiple AWS profiles and SSO authentication.
• Multi-region support.
• Secure credential handling, utilizing local AWS credentials without exposing them externally.
• Local execution with your AWS credentials.

Prerequisites

• Node.js
• Claude Desktop
• AWS credentials configured locally (~/.aws/ directory)

Installation

1. Clone the repository:

git clone https://github.com/RafalWilinski/aws-mcp
cd aws-mcp

2. Install dependencies:

pnpm install
# or
npm install

Usage

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

2. Add the following entry to your claude_desktop_config.json:

{
  "mcpServers": {
    "aws": {
      "command": "npm", // OR pnpm
      "args": [
        "--silent",
        "--prefix",
        "/Users/<YOUR USERNAME>/aws-mcp",
        "start"
      ]
    }
  }
}

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

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

4. 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"

Using with nvm

Build from source first and add following config:

{
  "mcpServers": {
    "aws": {
      "command": "/Users/<USERNAME>/.nvm/versions/node/v20.10.0/bin/node",
      "args": [
        "<WORKSPACE_PATH>/aws-mcp/node_modules/tsx/dist/cli.mjs",
        "<WORKSPACE_PATH>/aws-mcp/index.ts",
        "--prefix",
        "<WORKSPACE_PATH>/aws-mcp",
        "start"
      ]
    }
  }
}

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>