AWS Cognito MCP Server

AWS Cognito MCP Server

Una implementación de servidor de Model Context Protocol (MCP) que se conecta a AWS Cognito para autenticación y gestión de usuarios. Este servidor proporciona un conjunto de herramientas para flujos de autenticación de usuarios, incluyendo registro, inicio de sesión, gestión de contraseñas y más.

Requisitos previos

• Cuenta de AWS con un Cognito User Pool configurado
• Node.js 18 o superior

Instalación

# Clone the repository
git clone https://github.com/yourusername/mcp-server-aws-cognito.git

# Install dependencies
cd mcp-server-aws-cognito
npm install

# Build the server
npm run build

Configuración de AWS Cognito

1. Inicie sesión en su consola de AWS y navegue a Amazon Cognito
2. Cree un User Pool o use uno existente
3. Anote su User Pool ID y App Client ID
4. Establezca estos valores como variables de entorno o en un archivo .env (solo necesita el archivo .env cuando usa claude code, no claude desktop):

AWS_COGNITO_USER_POOL_ID=your-user-pool-id
AWS_COGNITO_USER_POOL_CLIENT_ID=your-app-client-id

Herramientas disponibles

Nombre de la herramienta	Descripción	Parámetros
sign_up	Registrar un nuevo usuario	email: string, password: string
sign_up_confirm_code_from_email	Verificar la cuenta con el código de confirmación	username: string, confirmationCode: string
sign_in	Autenticar a un usuario	username: string, password: string
sign_out	Cerrar sesión del usuario actual	Ninguno
getCurrentUser	Obtener el usuario actual con sesión iniciada	Ninguno
reset_password_send_code	Solicitar código de restablecimiento de contraseña	username: string
reset_password_veryify_code	Restablecer contraseña con código de verificación	username: string, code: string, newPassword: string
change_password	Cambiar contraseña para el usuario con sesión iniciada	oldPassword: string, newPassword: string
refresh_session	Refrescar los tokens de autenticación	Ninguno
update_user_attributes	Actualizar atributos del perfil de usuario	attributes: Array de {name: string, value: string}
delete_user	Eliminar el usuario actual con sesión iniciada	Ninguno
resend_confirmation_code	Reenviar código de verificación de cuenta	username: string
verify_software_token	Verificar TOTP para MFA	username: string, totpCode: string

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Uso con Claude Desktop

Antes de comenzar, asegúrese de que Node.js esté instalado en su escritorio para que npx funcione.

1. Vaya a: Configuración > Desarrollador > Editar configuración

2. Agregue lo siguiente a su claude_desktop_config.json:

{
  "mcpServers": {
    "aws-cognito-mcp-server": {
      "command": "/path/to/mcp-server-aws-cognito/build/index.js",
      "env": {
        "AWS_COGNITO_USER_POOL_ID": "your-user-pool-id",
        "AWS_COGNITO_USER_POOL_CLIENT_ID": "your-app-client-id"
      }
    }
  }
}

Uso con Claude Code

Claude Code es una interfaz de línea de comandos para Claude. Para usar este servidor MCP con Claude Code:

1. Instale Claude Code siguiendo las instrucciones en Documentación de Claude Code

2. Agregue el servidor MCP a Claude Code:

claude mcp add "aws-cognito-mcp" npx tsx index.ts

3. Verifique que se haya agregado:

claude mcp list

4. Ejecute Claude con su servidor MCP:

claude

Desarrollo

Para desarrollo con reconstrucción automática:

npm run watch

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Use el MCP Inspector para una mejor visibilidad:

npm run inspector

¡Ahora puede usar las herramientas de autenticación de AWS Cognito con Claude!