gitCarrot
服务介绍
AWS Cognito MCP 服务器
这是一个实现了 Model Context Protocol (MCP) 的服务器,它连接到 AWS Cognito 进行身份验证和用户管理。该服务器提供了一套工具用于用户认证流程,包括注册、登录、密码管理等。
先决条件
- 配置了 Cognito 用户池的 AWS 账户
- Node.js 18 或更高版本
安装
bash
克隆仓库
git clone https://github.com/yourusername/mcp-server-aws-cognito.git
安装依赖
cd mcp-server-aws-cognito
npm install
构建服务器
npm run build
AWS Cognito 配置
- 登录您的 AWS 控制台并导航至 Amazon Cognito
- 创建一个用户池或使用现有的用户池
- 记下您的用户池 ID 和应用客户端 ID
- 将这些值设置为环境变量或在 .env 文件中(仅当您使用 claude code 而不是 claude desktop 时需要 .env 文件):
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 正常工作。
-
前往:设置 > 开发者 > 编辑配置
-
在您的
claude_desktop_config.json中添加以下内容:
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 一起使用:
-
按照 Claude Code 文档中的说明安装 Claude Code。
-
向 Claude Code 添加 MCP 服务器:
bash
claude mcp add "aws-cognito-mcp" npx tsx index.ts -
验证是否已添加:
bash
claude mcp list -
运行带有您的 MCP 服务器的 Claude:
bash
claude
开发
对于带有自动重建功能的开发:
bash
npm run watch
调试
由于 MCP 服务器通过 stdio 通信,调试可能会比较困难。请使用 MCP Inspector 以获得更好的可见性:
bash
npm run inspector
现在您可以使用 AWS Cognito 认证工具与 Claude 一起工作了!