MCP Oauth2 Aws Cognito

🚀 MCP + OAuth2.1 + アマゾンCognitoによるモデルコンテキストプロトコルの認証サンプルプロジェクト

このプロジェクトは、モデルコンテキストプロトコル（MCP）とOAuth2.1を組み合わせ、アマゾンCognitoを認可サーバーとして使用したサンプルプロジェクトです。実際のアプリケーションにおけるモデルコンテキストプロトコルベースのセキュリティ認証と認可フローの実装方法を示しています。

🚀 クイックスタート

前提条件

1. 環境要件：
   • Node.jsがインストールされていること。
   • 以下のリソース権限を持つアマゾンAWSのテストアカウントが必要です：
     • Cognitoユーザープール（OAuth2.1認可サーバー用）。
     • API Gateway、Lambda、DynamoDB（動的クライアント登録機能に使用）。
     • CloudFormation（リソーススタックのデプロイに使用）。
2. 基本知識：
   • モデルコンテキストプロトコル（MCP）の基本概念を理解していること。
   • OAuth2.1プロトコルの仕組みを把握していること。

デプロイ手順

1. プロジェクトリポジトリをクローンします：

   git clone https://github.com/empires-security/mcp-oauth2-aws-cognito.git
   cd mcp-oauth2-aws-cognito
   

2. 依存関係をインストールします：

   npm run install:all
   

3. アマゾンクラウドリソースをデプロイします：

   npm run deploy
   

4. 生成された.envファイルを更新します：
   • src/client/.env、src/auto-client/.env、src/mcp-server/.envの設定を確認して更新します。
   • .env.exampleと比較して、すべての環境変数が正しく設定されていることを確認します。

✨ 主な機能

プロジェクトの概要

技術選択

• モデルコンテキストプロトコル（MCP）：モデル間の相互作用ルールを定義および管理するために使用されます。
• OAuth2.1：セキュアな認証と認可メカニズムを実装します。
• アマゾンCognito：ユーザー認証機能を提供するユーザーIDプールとして使用されます。

主要コンポーネント

1. MCPサーバー：
   • モデルコンテキストプロトコルのセキュリティサービスを実装します。
   • ロールベースのアクセス制御（RBAC）機能を提供します。
   • OAuth2.1認可サーバーとの統合をサポートします。
2. OAuth2.1認可サーバー：
   • アマゾンCognitoをユーザープールとして使用して、認証と認可機能を実装します。
   • パスワード付与、クライアント_資格情報などの標準的なOAuth2.1プロトコルフローをサポートします。
3. 自動化クライアント：
   • 自動発見機能を備え、最寄りのMCPサーバーを動的に識別して接続できます。
   • OAuth2.1モジュールを統合し、自動認可フローをサポートします。
4. 手動構成クライアント：
   • 手動構成オプションを提供し、ユーザーがMCPサーバーとOAuth2.1認可サーバーのパラメータをカスタマイズできます。
   • 多要素認証（MFA）や証明書バインディングなどの高度な機能をサポートします。

主な特徴

• 動的発見メカニズム：クライアントが最寄りのMCPサーバーを自動的に識別して接続できます。
• OAuth2.1統合：アマゾンCognitoのIDプールとのシームレスな接続をサポートします。
• ロール管理：モデルコンテキストプロトコルに基づくロール定義により、細粒度のアクセス制御を実現します。

📚 ドキュメント

プロジェクトアーキテクチャ

全体アーキテクチャ

• MCPサービス層：
  • モデルコンテキストプロトコルのセキュリティ検証と認可機能を提供します。
  • OAuth2.1認可サーバーとの統合をサポートします。
• OAuth2.1認可サーバー：
  • アマゾンCognitoユーザープールを使用して認証を実装します。
  • OAuth2.1トークンの発行、更新などのフローを処理します。
• クライアント層：
  • 自動化クライアントと手動構成クライアントの2種類があります。
  • 自動化クライアントは自動発見機能を備え、MCPサーバーに動的に接続できます。
  • 手動構成クライアントはカスタム構成をサポートし、複雑な環境に適しています。

重要コンポーネント

1. モデルコンテキストプロトコルサービス（MCP-Server）：
   • ロールベースのアクセス制御機能を提供します。
   • OAuth2.1認可サーバーとのセキュアな統合をサポートします。
2. OAuth2.1モジュール：
   • 標準的なOAuth2.1プロトコルフローを実装します。
   • アマゾンCognitoユーザープールと接続し、認証サービスを提供します。
3. 自動発見メカニズム：
   • クライアントが最寄りのMCPサーバーを動的に識別して接続できます。
   • 負荷分散と障害復旧機能をサポートします。

プロジェクト構造

主要ディレクトリ

1. mcp-server：
   • モデルコンテキストプロトコルのセキュリティサービスを実装します。
   • ロールベースのアクセス制御機能を提供します。
2. oauth-server：
   • アマゾンCognitoユーザープールを使用してOAuth2.1認可サーバーを実装します。
   • パスワード付与、クライアント_資格情報などの標準的なフローをサポートします。
3. client：
   • 手動構成のクライアント実装を提供します。
   • MCPサーバーとOAuth2.1認可サーバーの構成をカスタマイズできます。
4. auto-client：
   • 自動発見機能を備えた自動化クライアントモジュールです。
   • OAuth2.1モジュールを統合し、動的な認可フローをサポートします。

💻 使用例

サービスの起動

1. MCPサーバーを起動します：

   cd mcp-server && npm start
   

2. OAuth2.1認可サーバーを起動します：

   cd oauth-server && npm start
   

3. 手動構成クライアントを起動します：

   cd client && npm start
   

4. 自動化クライアントを起動します：

   cd auto-client && npm start
   

サンプルコマンド

1. プロジェクトをデプロイします：

   npm run deploy
   

2. 環境変数を更新します：

   cp .env.example .env
   

👨‍💻 プロジェクトの作者

開発チーム：

• 帝国安全研究所（Empire Security Lab）：モデルコンテキストプロトコルとOAuth2.1プロトコルの研究と実装に特化しています。

連絡先情報：

• メール：contact@empiresecuritylab.com
• 公式サイト：https://www.empiresecuritylab.com

📄 ライセンス

このプロジェクトはMIT Licenseに従っています。