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 の設定

AWSコンソールにログインし、Amazon Cognitoに移動します。
ユーザープールを作成するか、既存のユーザープールを使用する
ユーザープールIDとアプリクライアントIDをメモしてください
これらの値を環境変数として設定するか、.env ファイルで設定します (.env ファイルは、claude デスクトップではなく、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` : 文字列

インスペクターは、ブラウザでデバッグツールにアクセスするための URL を提供します。

Claude Desktopでの使用

開始する前に、 npxが動作するためにデスクトップにNode.jsがインストールされていることを確認してください。

設定 > 開発者 > 設定の編集に移動します
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で使用するには、以下の手順に従ってください。

Claude Codeドキュメントの指示に従ってClaude Codeをインストールします。
Claude Code に MCP サーバーを追加します。

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

追加されたことを確認します:

claude mcp list

MCP サーバーで Claude を実行します。

claude

発達

自動リビルドを使用した開発の場合:

npm run watch

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。MCPインスペクターを使用すると、より詳細な情報を得ることができます。

npm run inspector

これで、Claude で AWS Cognito 認証ツールを使用できるようになりました。

AWS Cognito MCP Server

Integrations