AWS MCP

Un servidor Model Context Protocol (MCP) que permet als assistents d’IA com Claude interactuar amb el vostre entorn AWS. Això permet consultar i gestionar els recursos AWS amb llenguatge natural durant les converses. Penseu en una millor alternativa a Amazon Q.

Features

• 🔍 Consultar i modificar recursos AWS amb llenguatge natural
• ☁️ Suport per a múltiples perfils AWS i autenticació SSO
• 🌐 Suport multi-regió
• 🔐 Gestió segura de credencials (no es revelen credencials a serveis externs, s’utilitzen les credencials locals)
• 🏃‍♂️ Execució local amb les vostres credencials AWS

Prerequisites

• Node.js
• Claude Desktop
• Credencials AWS configurades localment (~/.aws/ directory)

Installation

1. Clonau el repositori:

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

2. Instal·leu les dependències:

pnpm install
# o
npm install

Usage

1. Obriu l’aplicació de Claude Desktop i aneu a Settings > Developer > Edit Config

2. Afegeix la següent entrada al vostre claude_desktop_config.json:

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

Important: Reemplaceu /Users/<YOUR USERNAME>/aws-mcp amb el camí real al vostre directori de projecte.

3. Reinicieu l’aplicació de Claude Desktop. Hauríeu de veure això:

4. Comenceu seleccionant un perfil AWS o directament realitzant una acció preguntant:

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

Construïu primer el codi font i afegiu la següent configuració:

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

Per veure els registres:

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

Features in Development

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