1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Agent Plugins for AWS の内部構造を企業利用の視点で分析した(2026/03/25版)

1
Last updated at Posted at 2026-04-01

フリーソフトやクラウドサービスを企業に導入する際、そのソフトウェアが内部で何と通信し、どのような外部依存を持つかを把握する必要がある。特にクラウドサービスでは外部へのデータ送信先の特定、生成AI機能を含む場合はユーザーデータの二次利用(AI学習への利用等)に関するポリシーの確認が求められる。本記事では Agent Plugins for AWS のソースコードを調査し、内部構造について整理した。

この記事の要約

  • Agent Plugins for AWS は AI Agent → Plugin(Skill / Hook)→ MCP Server / Tool → External Service の4層構造で動作する
  • プラグインは MCP Server / Tool を uvx(PyPI)や GitHub Releases から自動導入し、AWS API やリモートサービスと通信する
  • すべての PyPI パッケージは @latest 指定でバージョンが固定されていない
  • 通信先の一部(aws-mcp.us-east-1.api.awsknowledge-mcp.global.api.aws)は現時点では AWS の法的文書(利用規約、プライバシーポリシー等)にまだ記載されていない
  • aurora-dsql-mcp-server は API Gateway の自動生成ドメイン(xmfe3hc3pk.execute-api.us-east-2.amazonaws.com)をデフォルトの通信先としてハードコードしており、その用途・データの扱いに関する説明はない
  • 調査対象: awslabs/agent-plugins v1.0.0、awslabs/mcpaws-samples/aurora-dsql-loader(2026/03/25 時点)

全体アーキテクチャ

Agent Plugins for AWS は、AI コーディングエージェント(Claude Code / Cursor)に AWS 開発能力を追加するプラグイン集である。

動作は以下の4層で構成される。

Agent Plugins for AWS アーキテクチャ図

役割
AI Agent Claude Code や Cursor。ユーザーの意図を解釈し、Plugin 層の Skill を自動起動する
Plugin(Skill / Hook) Skill は Markdown で記述された指示ファイルで、ユーザーの意図に応じて自動トリガーされる。Hook はツール使用後に自動実行される品質ゲート
MCP Server / Tool Plugin が自動導入する外部ソフトウェア。AWS API との通信を仲介する
External Service AWS の各種 API エンドポイント

プラグインと Skill / Hook の一覧

Plugin Skill / Hook 開発業務における位置付け
amazon-location-service Skill: location-service 地理空間機能の設計・実装(API 選定、認証方式、SDK 組み込み)
aws-amplify Skill: amplify-workflow フルスタックアプリの段階的構築(バックエンド定義→検証→フロントエンド接続→デプロイ)
aws-serverless Skill: aws-lambda サーバーレス設計・実装・運用(イベントソース選定、可観測性設計、コールドスタート対策)
Skill: api-gateway API アーキテクチャ設計・実装(API タイプ選定、認証方式設計、SAM/CFn テンプレート生成)
Skill: aws-serverless-deployment サーバーレス IaC・CI/CD(SAM/CDK プロジェクト構成、デプロイパイプライン構築)
Skill: aws-lambda-durable-functions 長時間ワークフロー設計・実装(Durable Functions vs Step Functions、Saga パターン)
Hook: SAM validate IaC 品質ゲート(Edit / Write 後に sam validate --lint を自動実行)
databases-on-aws Skill: dsql 分散 SQL データベース設計・運用(スキーマ設計、マイグレーション、MCP 経由のクエリ実行)
Hook: schema verify DB 変更の安全弁(transact 操作後にスキーマ・行数の確認を促す)
deploy-on-aws Skill: deploy AWS デプロイの全フェーズ(コード分析→サービス選定→コスト見積→IaC 生成→デプロイ)
migration-to-aws Skill: gcp-to-aws GCP→AWS 移行の全フェーズ(リソース検出→アーキテクチャ設計→コスト比較→実行計画)

出典: 各プラグインの .claude-plugin/plugin.jsonhooks/hooks.jsonskills/*/SKILL.md

MCP Server / Tool 層

各プラグインは .mcp.json で MCP Server / Tool を定義している。プラグインのインストール時に自動で導入される。

起動方式

3つの方式がある。

方式 仕組み
uvx(stdio) PyPI パッケージを自動取得しローカルプロセスとして実行 awslabs.aws-serverless-mcp-server
HTTP リモートの MCP Server に直接 HTTPS 接続 https://knowledge-mcp.global.api.aws
shell シェルスクリプトが GitHub Releases からバイナリを取得・実行 aurora-dsql-loaderloader.sh 経由)

プラグインと MCP Server / Tool の対応

Plugin MCP Server / Tool 起動方式 パッケージ / URL
amazon-location-service aws-mcp uvx mcp-proxy-for-aws@latest(PyPI)
aws-amplify aws-mcp uvx mcp-proxy-for-aws@latest(PyPI)
aws-serverless aws-serverless-mcp uvx awslabs.aws-serverless-mcp-server@latest(PyPI)--allow-write 付き
databases-on-aws awsknowledge HTTP https://knowledge-mcp.global.api.aws
aurora-dsql uvx awslabs.aurora-dsql-mcp-server@latest(PyPI)※デフォルト無効
aurora-dsql-loader shell GitHub Releases からバイナリ取得(loader.sh
deploy-on-aws awsknowledge HTTP https://knowledge-mcp.global.api.aws
awspricing uvx awslabs.aws-pricing-mcp-server@latest(PyPI)
awsiac uvx awslabs.aws-iac-mcp-server@latest(PyPI)
migration-to-aws awsknowledge HTTP https://knowledge-mcp.global.api.aws
awspricing uvx awslabs.aws-pricing-mcp-server@latest(PyPI)

出典: 各プラグインの .mcp.json

補足:

  • すべての uvx パッケージは @latest 指定であり、バージョンが固定されていない
  • aws-serverless-mcp-server--allow-write フラグがデフォルトで有効。MCP Server がユーザーの作業ディレクトリにファイルを書き込む権限を持つ
  • aurora-dsql.mcp.json"disabled": true に設定されている。ユーザーが手動で有効化した場合のみ起動する
  • aurora-dsql-loaderloader.sh が初回実行時に GitHub Releases からバイナリをダウンロードし ~/.local/bin/ に配置する。ダウンロード URL のドメイン検証とバイナリ形式の検証は実装されているが、チェックサム検証(SHA256 等)は行われない

パッケージの出典リポジトリ

uvx で自動導入される PyPI パッケージは、awslabs/agent-plugins リポジトリとは別のリポジトリで開発されている。

PyPI パッケージ 出典リポジトリ
mcp-proxy-for-aws aws/mcp-proxy-for-aws
awslabs.aws-serverless-mcp-server awslabs/mcp
awslabs.aurora-dsql-mcp-server awslabs/mcp
awslabs.aws-iac-mcp-server awslabs/mcp
awslabs.aws-pricing-mcp-server awslabs/mcp
バイナリ 出典リポジトリ
aurora-dsql-loader aws-samples/aurora-dsql-loader

通信先と法的文書の対応

各 MCP Server / Tool が通信する外部サービスのエンドポイントと、AWS の法的文書(利用規約、プライバシーポリシー等)での記載有無を整理する。

通信先一覧

通信先 用途 利用する MCP Server / Tool AWS 法的文書での記載
*.{region}.amazonaws.com AWS SDK 標準 API(Pricing, CloudFormation, CloudTrail, DSQL 等) awspricing, awsiac, aws-serverless-mcp, aurora-dsql, aurora-dsql-loader あり(AWS 利用規約の対象)
aws-mcp.us-east-1.api.aws AWS MCP 専用 API(ドキュメント・サービスガイダンス) aws-mcp(mcp-proxy-for-aws 経由) 現時点では記載なし
knowledge-mcp.global.api.aws AWS Knowledge MCP API(ドキュメント・アーキテクチャガイダンス) awsknowledge(HTTP 直接接続) 現時点では記載なし
xmfe3hc3pk.execute-api.us-east-2.amazonaws.com DSQL Knowledge Tools(ドキュメント検索・推奨)のリモートエンドポイント aurora-dsql-mcp-server の --knowledge-server デフォルト値(変更可能) 現時点では記載なし
api.github.com aurora-dsql-loader のバイナリダウンロード loader.sh N/A(GitHub の利用規約が適用)

出典:

  • *.amazonaws.com: AWS 各サービスの標準エンドポイント
  • aws-mcp.us-east-1.api.aws: awslabs/agent-pluginsplugins/amazon-location-service/.mcp.jsonplugins/aws-amplify/.mcp.json
  • knowledge-mcp.global.api.aws: awslabs/agent-pluginsplugins/deploy-on-aws/.mcp.jsonplugins/databases-on-aws/.mcp.jsonplugins/migration-to-aws/.mcp.json
  • xmfe3hc3pk.execute-api.us-east-2.amazonaws.com: awslabs/mcpsrc/aurora-dsql-mcp-server/awslabs/aurora_dsql_mcp_server/server.py:654--knowledge-server の argparse デフォルト値。変更可能だが用途・データの扱いの説明なし。README には "By default it is pre-configured" "For security, only use trusted knowledge server endpoints" とのみ記載)
  • api.github.com: awslabs/agent-pluginsplugins/databases-on-aws/scripts/loader.sh:247

法的文書の確認状況

  • AWS の公式プライバシーポリシー(https://aws.amazon.com/privacy/ )と利用規約を確認した
  • awslabs/agent-plugins リポジトリには独立したプライバシーポリシー・利用規約は存在しない。ソフトウェアライセンスとして Apache-2.0 が適用される
  • aws-mcp.us-east-1.api.aws および knowledge-mcp.global.api.aws*.api.aws ドメインに属するが、これらの MCP 専用 API に関する記載は現時点では AWS の法的文書にまだ見つかっていない(2026/03/25 時点)
  • xmfe3hc3pk.execute-api.us-east-2.amazonaws.comaurora-dsql-mcp-server--knowledge-server のデフォルト値としてソースコードにハードコードされた API Gateway 自動生成ドメインである。--knowledge-server 引数で変更可能だが、デフォルト値の運営主体・データの扱いに関する説明は README・ソースコード中に存在しない

本記事は 2026/03/25 時点のソースコードに基づく事実整理である。Agent Plugins for AWS は活発に開発が進んでおり、構造や通信先は今後変わる可能性がある。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?