AWS MCP

Interactúa con tu entorno de AWS usando lenguaje natural para consultar y gestionar recursos. Requiere credenciales locales de AWS.

Documentación

AWS MCP

Un servidor Model Context Protocol (MCP) que permite a asistentes de IA como Claude interactuar con tu entorno de AWS. Esto permite consultar y gestionar tus recursos de AWS en lenguaje natural durante las conversaciones. Piensa en una mejor alternativa a Amazon Q.

AWS MCP

Características

  • 🔍 Consulta y modifica recursos de AWS usando lenguaje natural
  • ☁️ Soporte para múltiples perfiles de AWS y autenticación SSO
  • 🌐 Soporte multi-región
  • 🔐 Manejo seguro de credenciales (ninguna credencial se expone a servicios externos, se usan tus credenciales locales)
  • 🏃‍♂️ Ejecución local con tus credenciales de AWS

Requisitos previos

Instalación

  1. Clona el repositorio:
git clone https://github.com/RafalWilinski/aws-mcp
cd aws-mcp
  1. Instala las dependencias:
pnpm install
# or
npm install

Uso

  1. Abre la aplicación de escritorio de Claude y ve a Configuración -> Desarrollador -> Editar configuración

Claude Settings

  1. Añade la siguiente entrada a tu claude_desktop_config.json:
{
  "mcpServers": {
    "aws": {
      "command": "npm", // OR pnpm
      "args": [
        "--silent",
        "--prefix",
        "/Users/<YOUR USERNAME>/aws-mcp",
        "start"
      ]
    }
  }
}

Importante: Reemplaza /Users/<YOUR USERNAME>/aws-mcp con la ruta real a tu directorio de proyecto.

  1. Reinicia la aplicación de escritorio de Claude. Deberías ver esto:

Claude MCP Connection Status

  1. Comienza seleccionando un perfil de AWS o pasa a la acción preguntando:
    • "Lista los perfiles de AWS disponibles"
    • "Lista todas las instancias EC2 de mi cuenta"
    • "Muéstrame los buckets de S3 con sus tamaños"
    • "¿Qué funciones Lambda están desplegadas en us-east-1?"
    • "Lista todos los clústeres de ECS y sus servicios"

Usando con nvm

Compila desde el código fuente primero y añade la siguiente configuración:

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

Solución de problemas

Para ver los registros:

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

Características en desarrollo

  • Soporte MFA
  • Almacenar en caché las credenciales SSO para evitar actualizarlas con demasiada frecuencia

aws-mcp MCP server