AWS Cognito MCP Server

AWS Cognito MCP サーバー

AWS Cognito に接続して、認証とユーザー管理を行う Model Context Protocol（MCP）サーバーの実装です。このサーバーは、サインアップ、サインイン、パスワード管理など、ユーザー認証フロー用の一連のツールを提供します。

前提条件

• Cognito User Pool が設定された 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 Console にログインし、Amazon Cognito に移動します
2. User Pool を作成するか、既存のものを使用します
3. User Pool ID と App Client ID を控えます
4. これらの値を環境変数または .env ファイルに設定します（.env ファイルが必要なのは claude code を使用する場合のみで、claude desktop では不要です）。

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

利用可能なツール

ツール名	説明	パラメーター
sign_up	新しいユーザーを登録します	email: string, password: string
sign_up_confirm_code_from_email	確認コードでアカウントを認証します	username: string, confirmationCode: string
sign_in	ユーザーを認証します	username: string, password: string
sign_out	現在のユーザーをサインアウトします	なし
getCurrentUser	現在サインインしているユーザーを取得します	なし
reset_password_send_code	パスワードリセットコードをリクエストします	username: string
reset_password_veryify_code	確認コードを使用してパスワードをリセットします	username: string, code: string, newPassword: string
change_password	サインインしているユーザーのパスワードを変更します	oldPassword: string, newPassword: string
refresh_session	認証トークンを更新します	なし
update_user_attributes	ユーザープロフィールの属性を更新します	attributes: Array of {name: string, value: string}
delete_user	現在サインインしているユーザーを削除します	なし
resend_confirmation_code	アカウント確認コードを再送信します	username: string
verify_software_token	MFA 用の TOTP を確認します	username: string, totpCode: string

Inspector により、ブラウザーでデバッグツールにアクセスするための URL が表示されます。

Claude Desktop での使用

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

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 認証ツールを使用できます！