AWS Cognito MCP Server

AWS Cognito MCP Server

Uma implementação de servidor Model Context Protocol (MCP) que se conecta ao AWS Cognito para autenticação e gerenciamento de usuários. Este servidor fornece um conjunto de ferramentas para fluxos de autenticação de usuários, incluindo cadastro, login, gerenciamento de senha e mais.

Pré-requisitos

• Conta AWS com User Pool do Cognito configurado
• Node.js 18 ou superior

Instalação

# 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

Configuração do AWS Cognito

1. Faça login no seu Console AWS e navegue até o Amazon Cognito
2. Crie um User Pool ou use um existente
3. Anote o ID do seu User Pool e o App Client ID
4. Defina esses valores como variáveis de ambiente ou em um arquivo .env (você precisa do arquivo .env apenas quando usar o claude code, não o claude desktop):

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

Ferramentas Disponíveis

Nome da Ferramenta	Descrição	Parâmetros
sign_up	Registrar um novo usuário	email: string, password: string
sign_up_confirm_code_from_email	Verificar conta com código de confirmação	username: string, confirmationCode: string
sign_in	Autenticar um usuário	username: string, password: string
sign_out	Sair do usuário atual	Nenhum
getCurrentUser	Obter o usuário atualmente conectado	Nenhum
reset_password_send_code	Solicitar código de redefinição de senha	username: string
reset_password_veryify_code	Redefinir senha com código de verificação	username: string, code: string, newPassword: string
change_password	Alterar senha do usuário conectado	oldPassword: string, newPassword: string
refresh_session	Atualizar os tokens de autenticação	Nenhum
update_user_attributes	Atualizar atributos do perfil do usuário	attributes: Array de {name: string, value: string}
delete_user	Excluir o usuário atualmente conectado	Nenhum
resend_confirmation_code	Reenviar código de verificação da conta	username: string
verify_software_token	Verificar TOTP para MFA	username: string, totpCode: string

O Inspector fornecerá uma URL para acessar ferramentas de depuração no seu navegador.

Usando com o Claude Desktop

Antes de começar, certifique-se de que o Node.js está instalado no seu desktop para que o npx funcione.

1. Vá para: Configurações > Desenvolvedor > Editar Config

2. Adicione o seguinte ao seu 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"
      }
    }
  }
}

Usando com o Claude Code

O Claude Code é uma interface de linha de comando para o Claude. Para usar este servidor MCP com o Claude Code:

1. Instale o Claude Code seguindo as instruções em Documentação do Claude Code

2. Adicione o servidor MCP ao Claude Code:

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

3. Verifique se foi adicionado:

claude mcp list

4. Execute o Claude com o seu servidor MCP:

claude

Desenvolvimento

Para desenvolvimento com reconstrução automática:

npm run watch

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Use o MCP Inspector para melhor visibilidade:

npm run inspector

Agora você pode usar as ferramentas de autenticação do AWS Cognito com o Claude!