aws-mcp

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.

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

  1. 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.

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

  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"

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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

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. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Using with nvm
            1. Troubleshooting
              1. Features in Development

                Related MCP Servers

                • A
                  security
                  F
                  license
                  A
                  quality
                  Model Context Protocol (MCP) server that integrates Redash with AI assistants like Claude, allowing them to query data, manage visualizations, and interact with dashboards through natural language.
                  Last updated -
                  10
                  53
                  16
                  JavaScript
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol (MCP) server that allows AI agents like Claude to interact with the Aligo SMS API to send text messages and retrieve related information.
                  Last updated -
                  JavaScript
                  MIT License
                • -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server that enables Claude to generate and execute AWS CLI commands, allowing users to manage AWS resources through natural language conversations.
                  Last updated -
                  1
                  TypeScript
                • -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server allowing Claude AI to interact with AWS resources through natural language, enabling users to query and manage AWS services without using the traditional AWS Console or CLI.
                  Last updated -
                  TypeScript
                  • Apple

                View all related MCP servers

                ID: ta7kdy57us