AWS Cognito MCP 服务器

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

前提条件

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

安装

# 克隆仓库
git clone https://github.com/yourusername/mcp-server-aws-cognito.git

# 安装依赖
cd mcp-server-aws-cognito
npm install

# 构建服务器
npm run build

AWS Cognito 配置

1. 登录到您的 AWS 控制台并导航到 Amazon Cognito
2. 创建一个用户池或使用现有的用户池
3. 记下您的用户池 ID 和应用程序客户端 ID
4. 将这些值设置为环境变量或在 .env 文件中（只有在使用 claude code 时才需要 .env 文件，而不是 claude desktop）：

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. 转到：设置 > 开发者 > 编辑配置

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

现在，您可以将 AWS Cognito 身份验证工具与 Claude 一起使用！