AWS Cognito MCP Server

AWS Cognito MCP 服务

一个用于连接 AWS Cognito 以实现身份验证和用户管理的模型上下文协议（MCP）服务实现。此服务提供一组用于用户身份验证流程的工具，包括注册、登录、密码管理等。

先决条件

• 配置了 Cognito 用户池的 AWS 账户
• Node.js 18 或更高版本

安装

# 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

AWS Cognito 配置

1. 登录 AWS 控制台并前往 Amazon Cognito
2. 创建用户池或使用现有用户池
3. 记下用户池 ID 和应用客户端 ID
4. 将这些值设置为环境变量，或写入 .env 文件（仅使用 Claude Code 时需要 .env 文件，使用 Claude 桌面版时则不需要）：

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

可用工具

工具名称	描述	参数
sign_up	注册新用户	email：字符串，password：字符串
sign_up_confirm_code_from_email	使用确认码验证账户	username：字符串，confirmationCode：字符串
sign_in	验证用户身份	username：字符串，password：字符串
sign_out	登出当前用户	无
getCurrentUser	获取当前登录用户	无
reset_password_send_code	请求密码重置码	username：字符串
reset_password_veryify_code	使用验证码重置密码	username：字符串，code：字符串，newPassword：字符串
change_password	修改已登录用户的密码	oldPassword：字符串，newPassword：字符串
refresh_session	刷新身份验证令牌	无
update_user_attributes	更新用户个人资料属性	attributes：{name: string, value: string} 数组
delete_user	删除当前登录用户	无
resend_confirmation_code	重新发送账户验证码	username：字符串
verify_software_token	验证 MFA 的 TOTP	username：字符串，totpCode：字符串

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

与 Claude Desktop 搭配使用

开始前，请确保桌面上已安装 Node.js，以便 npx 正常运行。

1. 前往：Settings > Developer > Edit Config

2. 将以下内容添加到 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"
      }
    }
  }
}

与 Claude Code 搭配使用

Claude Code 是 Claude 的命令行界面。要将此 MCP 服务与 Claude Code 搭配使用：

1. 按照 Claude Code 文档中的说明安装 Claude Code

2. 将 MCP 服务添加到 Claude Code：

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

3. 确认已添加：

claude mcp list

4. 使用 MCP 服务运行 Claude：

claude

开发

用于自动重建的开发方式：

npm run watch

调试

由于 MCP 服务通过 stdio 通信，调试可能会比较困难。使用 MCP Inspector 可以更清晰地查看运行情况：

npm run inspector

现在，你可以通过 Claude 使用 AWS Cognito 身份验证工具了！