本文にスキップ
AI News HubLIVE
サイト内リライト7 分で読了

プッシュベースアーキテクチャによる AWS Agent Registry の自動更新

記事の要約

この記事では、イベント駆動型のプッシュベースアーキテクチャを使用して AWS Agent Registry の MCP サーバーメタデータを自動的に最新の状態に保つ方法を紹介します。AWS CloudTrail、Amazon EventBridge、AWS Lambda、AgentCore Identity を活用し、MCP サーバーの変更を検出して、シークレットを保存することなく更新されたツールメタデータをレジストリにプッシュします。単一アカウント環境とマルチアカウント環境の両方をサポートします。

ソースAWS Machine Learning Blog著者: Prachi Kulkarni
プッシュベースアーキテクチャによる AWS Agent Registry の自動更新
誤りを報告

訂正窓口はまだ利用できません。記事情報をコピーして保存できます。

訂正案内
本文へ

AWS Agent Registry に公開されている Model Context Protocol(MCP)サーバーが新しいツールを追加したり、スキーマを更新したりするたびに、レジストリレコードも更新する必要があります。自動化されたプッシュベースの同期がないと、利用者は古いメタデータを発見してしまいます。複数のアカウントにまたがる複数の MCP サーバーを管理する組織にとって、このような同期は既存のガバナンスワークフロー内でカタログレコードを最新の状態に保ちます。

ほとんどのエンタープライズ展開では、カタログの価値はその鮮度に依存します。開発者が月曜日に新しいツールをデプロイしても、レジストリレコードが先週のスキーマを反映したままだと、利用者はカタログへの信頼を失います。古いメタデータはレジストリの信頼性を直接低下させ、チームが不正確な情報に基づいて依存関係を誤って構築する原因となります。

エンジニアが MCP サーバーにツールを追加したがカタログの更新を忘れた場合、次のような問題が発生します。利用者は新しい機能を完全に見逃します。アプリケーションが古いスキーマを使用してツールを呼び出し、予期しない実行時の動作やサイレントなワークフローの逸脱を引き起こす可能性があります。チーム全体に広がると、この自動化の欠如がレジストリへの信頼を損ないます。組織は最終的に、ハードコードされたエンドポイント、非公式な知識共有、古いドキュメントなどのアドホックな検出メカニズムに戻ってしまいます。

この記事では、AWS CloudTrail、Amazon EventBridge、AWS Lambda を使用してこれらの更新を自動化するイベント駆動型アーキテクチャの概要を説明します。

アーキテクチャの概要

このソリューションは、これらのサービスを組み合わせて、実行時の変更を検出し、レジストリに自動的に同期するイベント駆動型パイプラインを実現します。

このアーキテクチャは、マルチアカウント環境と単一アカウント環境の両方をサポートします。

単一アカウント設定:シンプルな展開の場合、すべてのコンポーネントがアカウント A 内に存在します。イベントはアカウント A 内で直接流れるため、クロスアカウント転送の設定は不要です。

マルチアカウント設定:2 つのアカウントが関与し、アカウント B からの実行時イベントがアカウント A に安全に転送されます。

アカウント A(レジストリアカウント)は、AWS Agent Registry、Amazon EventBridge ルール、プッシュ同期 Lambda 関数、および CloudTrail ログを所有します。

アカウント B(MCP サーバーアカウント)は、MCP サーバーランタイムと認証に使用される Amazon Cognito OAuth プロバイダーをホストします。

この例では 2 つのアカウントを使用しますが、アーキテクチャを複数のアカウントに拡張できます。アカウント A をレジストリアカウントとし、複数の AWS アカウントを異なる MCP サーバー用のアカウント B と同様に設定します。

次の図は、アカウント B での MCP サーバー更新のエンドツーエンドのイベントフローを示しています。キャプチャされたイベントはアカウント A に転送され、そこで Lambda 関数が MCP サーバーにクエリを実行してツールを取得し、一致するレジストリレコードを更新します。

図 1:クロスアカウント MCP サーバー更新のエンドツーエンドのイベントフロー(アカウント B の CloudTrail イベントからアカウント A のレジストリレコード更新まで)。

このアーキテクチャは 5 つの AWS サービスを使用します。

AWS CloudTrail は、UpdateAgentRuntime API 呼び出しを管理イベントとしてキャプチャします。

Amazon EventBridge は、一致するイベントを Lambda 関数にルーティングし、クロスアカウント転送をサポートします。

AWS Lambda は、MCP サーバーに現在のツールを照会し、レジストリと差分を比較し、変更があればレコードを更新します。

AWS Agent Registry は、MCP サーバーレコードとそのツールスキーマを中央の信頼できる情報源として保存します。

AgentCore Identity(Amazon Bedrock AgentCore の機能)は、OAuth トークン交換を安全に仲介するため、Lambda はシークレットを保存せずに認証できます。

仕組み:ビジネスロジックフロー

展開後、パイプラインは次のエンドツーエンドワークフローを実行します。

トリガー:アカウント B の開発者が MCP サーバーを更新すると、Amazon Bedrock AgentCore の UpdateAgentRuntime API が呼び出され、AWS CloudTrail がイベントをキャプチャします。

ルーティング:Amazon EventBridge が CloudTrail イベントをキャッチし、アカウント A の中央イベントバスに転送します。

解析:アカウント A の同期 Lambda がイベントペイロードからランタイム Amazon Resource Name(ARN)を抽出し、MCP サーバーの呼び出し URL を動的に構築します。これにより、アカウント B のどのサーバーをクエリするかがわかります。

認証:Lambda は AgentCore Identity を介して安全な OAuth ベアラートークンを生成します。

取得:Lambda は MCP サーバーを呼び出し(initialize、次に tools/list)、最新のツール情報を取得します。

同期:Lambda は ARN で一致するレジストリレコードを見つけ、差分を評価し、スキーマが変更されていればレジストリを更新します。

このフローは、アカウント A の Agent Registry に MCP サーバーの事前登録済みレコードが既に含まれていることを前提としています(初期オンボーディング時に作成)。このサンプルの Lambda 関数は既存のレコードのみを更新し、新しいレコードは生成しません。

同じフローは、すべてのリソース(レジストリ、Lambda、Amazon EventBridge ルール、MCP サーバー)が 1 つのアカウントに存在する単一アカウント設定でも機能します。その場合、クロスアカウント転送のステップをスキップします。イベントは同じアカウントの Amazon EventBridge バス内で直接流れます。

技術的なウォークスルー

このセクションでは、アーキテクチャ図に示すように、2 つのアカウントを使用した単一の MCP サーバー更新のワークフローを順を追って説明します。

UpdateAgentRuntime イベントを発行する各サーバーに対して、同じフローが独立して実行されます。Lambda は一度に 1 つのイベントを処理し、Amazon EventBridge の呼び出しモデルに合わせて自然にスケールします。

ステップ 1:クロスアカウント設定のイベントキャプチャとルーティング

開発者が MCP サーバーをデプロイまたは更新すると、AgentCore CLI(agentcore deploy)または直接のいずれかで UpdateAgentRuntime API が呼び出されます。

AWS CloudTrail はこれをアカウント B の管理イベントとして記録し、配信遅延は約 5~15 分です。その後、イベントはアカウント A のデフォルトの Amazon EventBridge バスに配信されます。

クロスアカウント設定の場合、アカウント B の Amazon EventBridge はクロスアカウントルールを介して一致するイベントをアカウント A のイベントバスに転送します。

アカウント A の Amazon EventBridge ルールターゲットは同期 Lambda を呼び出し、完全な CloudTrail イベント JSON を入力ペイロードとして渡します。

Amazon EventBridge ルールパターン:

{ "source": ["aws.bedrock-agentcore"], "detail-type": ["API Call via AWS CloudTrail"], "detail": { "eventName": ["UpdateAgentRuntime"] } }

ステップ 2:MCP サーバー URL の抽出

Lambda はイベントからランタイム ARN を解析します。ホスティングアカウント ID と AWS リージョンを抽出して、ターゲット MCP サーバーの URL エンコードされた呼び出しエンドポイントを動的に構築します。

AWS CloudTrail イベントペイロードからランタイム ARN を抽出

def _extract_mcp_url(event): detail = event.get("detail", {}) runtime_arn = detail.get("responseElements", {}).get("agentRuntimeArn", "") if not runtime_arn: return None, None

ARN からアカウント ID を解析(5 番目のコロン区切りセグメント)

arn_parts = runtime_arn.split(":") account_id = arn_parts[4] if len(arn_parts) > 4 else None region = detail.get("awsRegion", "us-west-2")

ARN を URL エンコードし、MCP 呼び出しエンドポイントを構築

encoded_arn = runtime_arn.replace(":", "%3A").replace("/", "%2F") mcp_url = (f"https://bedrock-agentcore.{region}.amazonaws.com" f"/runtimes/{encoded_arn}/invocations?qualifier=DEFAULT") return mcp_url, account_id

ステップ 3:AgentCore Identity による安全な認証

Lambda は 2 段階の ID フローを使用して認証します。実行 ID を一時的なワークロードトークンと交換します。次に Lambda は、ターゲットアカウントの資格情報プロバイダーを介してこのトークンをスコープ付き OAuth ベアラートークンと交換します。

def get_bearer_token(account_id=None): """AgentCore Identity 資格情報プロバイダーを介して OAuth ベアラートークンを取得します。

2 段階プロセス:

  1. AgentCore Identity からワークロードアクセストークンを取得(この Lambda を識別)
  2. それを使用して資格情報プロバイダーから OAuth トークンを取得(M2M フロー)

資格情報プロバイダーは Cognito/OAuth 設定を AgentCore Identity に安全に保存するため、Lambda 環境変数にクライアントシークレットは不要です。 """ acct = account_id or "" provider_name = os.environ.get(f"CREDENTIAL_PROVIDER_{acct}") or os.environ.get("CREDENTIAL_PROVIDER", "") scope_str = os.environ.get(f"CREDENTIAL_SCOPE_{acct}") or os.environ.get("CREDENTIAL_SCOPE", "") scopes = [s.strip() for s in scope_str.split(",") if s.strip()] if scope_str else [] workload_name = os.environ.get("WORKLOAD_IDENTITY_NAME", "") if not provider_name: raise ValueError(f"No CREDENTIAL_PROVIDER configured for account {acct}") if not workload_name: raise ValueError("WORKLOAD_IDENTITY_NAME env var not set") region = os.environ.get("AWS_REGION", "us-west-2") client = boto3.client("bedrock-agentcore", region_name=region)

ステップ 1:ワークロードアクセストークンを取得(この Lambda を信頼されたワークロードとして識別)

wat_response = client.get_workload_access_token( workloadName=workload_name, ) print(f"Workload access token response keys: {list(wat_response.keys())}") workload_token = wat_response.get("workloadAccessToken") or wat_response.get("accessToken", "") if not workload_token: raise ValueError(f"No access token in workload response: {list(wat_response.keys())}")

ステップ 2:ワークロードトークンを使用して資格情報プロバイダーから OAuth トークンを取得

response = client.get_resource_oauth2_token( workloadIdentityToken=workload_token, resourceCredentialProviderName=provider_name, oauth2Flow="M2M", scopes=scopes, ) return response["accessToken"]

資格情報プロバイダーはアカウントごと(CREDENTIAL_PROVIDER_{ACCT_ID})であるため、1 つの Lambda が複数のアカウントにまたがる MCP サーバーを認証できます。

ステップ 4:MCP サーバーのクエリ

標準の MCP ストリーミング可能な HTTP メカニズムを使用して、Lambda は initialize リクエストを介してアクティブなセッションを確立します。セッションがアクティブになった後、tools/list を呼び出して、現在公開されているツールとスキーマの完全な配列を取得します。

def call_tools_list(mcp_url, token): """MCP サーバーの initialize + tools/list メソッドを呼び出し、結果を返します。

MCP streamable-http では tools/list の前に initialize が必要です。 サーバーがセッションを使用する場合、initialize の session_id が tools/list に渡されます。 """

URL スキームを検証して file:// やカスタムスキームへのアクセスを防止

if not mcp_url.startswith("https://"): raise ValueError(f"Only HTTPS URLs are allowed, got: {mcp_url[:50]}")

ステップ 1:MCP セッションを初期化

init_payload = { "jsonrpc": "2.0", "id": "init-1", "method": "initialize", "params": { "protocolVersion": "2025-03-26", "capabilities": {}, "clientInfo": {"name": "tool-sync-lambda", "version": "1.0.0"}, }, } init_resp = requests.post( mcp_url, json=init_payload, headers=_mcp_headers(token), timeout=30, ) init_resp.raise_for_status() session_id = init_resp.headers.get("Mcp-Session-Id") init_result = _parse_sse_json(init_resp.text) print(f"MCP session initialized, session_id={session_id}")

ステップ 2:tools/list を呼び出す

list_payload = { "jsonrpc": "2.0", "id": "list-1", "method": "tools/list", "params": {}, } list_resp = requests.post( mcp_url, json=list_payload, headers=_mcp_headers(token, session_id), timeout=30, ) list_resp.raise_for_status() return _parse_sse_json(list_resp.text)

ステップ 5:一致するレジストリレコードの検索

Lambda は中央の Agent Registry にクエリを実行して、対応するレコードを特定します。APPROVED レコードの中から、mcpServer.data にレコード作成時に埋め込まれたランタイム ARN が含まれているものを検索します(デプロイセクションを参照)。

一致させるために MCP URL からランタイム ARN をデコード

def _find_record_by_mcp_url(client, registry_id, mcp_url): """サーバースキーマにランタイム ARN が含まれるレジストリレコードを検索します。

3 つの一致戦略を試します:

  1. デコードされた ARN(例:arn:aws:bedrock-agentcore:...:runtime/TrimMCP-xxx)
  2. URL エンコードされた ARN(例:arn%3Aaws%3Abedrock-agentcore%3A...%2FTrimMCP-xxx)
  3. 完全な MCP URL の一致

戻り値: (record_id, full_record) タプル。一致が見つからない場合は両方とも None。 """

一致させるために MCP URL からランタイム ARN を抽出

URL 形式:.../runtimes/arn%3A...%2Fruntime%2F/invocations...

デコードして取得:arn:aws:bedrock-agentcore:region:account:runtime/id

try: decoded_url = urllib.parse.unquote(mcp_url)

ランタイムパスのみを抽出:arn:aws:bedrock-agentcore:...:runtime/xxx

runtime_marker = "/runtimes/" idx = decoded_url.find(ru

要点と分析を開く

記事インテリジェンス

エンジニア中級

要点

  • CloudTrail が UpdateAgentRuntime API 呼び出しをキャプチャし、EventBridge がアカウント間でイベントを転送します。
  • Lambda は AgentCore Identity を使用して OAuth トークンを取得し、MCP サーバーをクエリしてレジストリレコードを更新します。
  • このソリューションは、Lambda にクライアントシークレットを保存せずに、単一アカウントおよびマルチアカウントのデプロイをサポートします。

要点と分析は自動生成され、誤りを含む場合があります。原典をご確認ください。