Aws MCP

🚀 AWS MCP - Model Context Protocol Server

AWS MCP (AWS MCP) is a model context protocol server that enables AI assistants like Claude to interact with your AWS environment. This makes it possible to query and manage your AWS resources using natural language in conversations. It can be regarded as a better alternative to Amazon Q.

✨ Features

• 🔍 Query and modify AWS resources using natural language.
• ☁️ Support multiple AWS configuration files and SSO authentication.
• 🌐 Support multiple regions.
• 🔐 Secure credential handling (credentials are not exposed to external services, using local credentials).
• 🏃‍♂️ Execute locally with your AWS credentials.

📦 Prerequisites

• Node.js
• Claude Desktop
• Locally configured AWS credentials (~/.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 Examples

Basic Usage

1. Open the Claude desktop application, go to Settings -> Developer -> Edit Configuration.

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 Note

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

3. Restart the Claude desktop application. You should see the following interface:

4. Start by selecting an AWS profile or performing operations directly:
   • "List available AWS profiles"
   • "List all EC2 instances in my account"
   • "Show S3 buckets and their sizes"
   • "What Lambda functions are there in us-east-1?"
   • "List all ECS clusters and their services"

Advanced Usage

Build from source code and add the following configuration:

{
  "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

View 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
• [ ] SSO credential caching to prevent overly frequent refreshes