AWS Diagram MCPを使用してAWSの構成図作成

Amazon Q Developer CLIでMCPを使用してAWSの構成図を作成してみます。
次のAWSブログ記事を参考に設定を進めます。

作業環境

• WSL 2
• Amazon Q Developer CLI（Claude 4 Sonnet）

MCP設定方法は過去記事を書いているので是非ご覧ください。

MCP設定

今回は作業するディレクトリ配下に.amazonq/mcp.jsonを作成しMCP設定を記載しました。

username@wsl:~/project/amazonq/diagram$ tree -a
.
└── .amazonq
    └── mcp.json

設定したMCP設定は次の通りです。

{
  "mcpServers": {
    "awslabs.aws-diagram-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-diagram-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "autoApprove": [],
      "disabled": false
    },
    "awslabs.aws-documentation-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "autoApprove": [],
      "disabled": false
    }
  }
}

q起動で設定確認

qコマンドでAmazon Q Developer CLIを起動すると次のように2つのMCP設定が読み込まれます。
設定したMCPが表示されていればOKです。

username@wsl:~/project/amazonq/diagram$ q
✓ awslabsaws_documentation_mcp_server loaded in 2.08 s
✓ awslabsaws_diagram_mcp_server loaded in 3.43 s

トラブルシューティング：q起動時のWARING

qコマンドで起動時に、次のようなWARINGなどが表示されることがあります。
この場合は、.amazonq/mcp.jsonに不要なコンマがありMCP設定読み込みに失敗しているという表示のため、MCP設定ファイルを修正する必要があります。
どのような問題が発生しているか表示してくれるので親切です。

username@wsl:~/project/amazonq/diagram$ q
WARNING: Error reading local mcp config: trailing comma at line 12 column 3
Please check to make sure config is correct. Discarding.
✓ awslabsaws_documentation_mcp_server loaded in 1.77 s

画像を生成する

次の指示をAmazon Q Developerへ与えて構成図を生成します。
このプロンプトは、AWSブログに記載のあるものをそのまま利用しています。

Please create a diagram showing an EC2 instance in a VPC connecting to an external S3 bucket. Include essential networking components (VPC, subnets, Internet Gateway, Route Table), security elements (Security Groups, NACLs), and clearly mark the connection between EC2 and S3. Label everything appropriately concisely and indicate that all resources are in the us-east-1 region. Check for AWS documentation to ensure it adheres to AWS best practices before you create the diagram.

（日本語訳）
VPC内のEC2インスタンスが外部のS3バケットに接続する図を作成してください。必須のネットワーキング・コンポーネント（VPC、サブネット、インターネット・ゲートウェイ、ルート・テーブル）、セキュリティ要素（セキュリティ・グループ、NACL）を含め、EC2とS3間の接続を明確にマークしてください。すべてに適切なラベルを簡潔に付け、すべてのリソースがus-east-1リージョンにあることを示す。図を作成する前に、AWSのベストプラクティスに準拠していることを確認するために、AWSのドキュメントをチェックする。

1. AWS Documentation MCPを利用したドキュメント検索

まずは次のような形でAWS Documentation MCPを利用してドキュメント検索が始まります。必要に応じてyやtでツール利用を許可してください。

2. AWS Diagram MCPを利用した画像生成

ツールを利用して必要なAWSサービスアイコンを一覧化し、画像を生成します。

生成された画像のパスが表示され、この構成図がどんな構成なのかという説明も生成してくれる。

3. 生成された構成図

これが生成された構成図。一応構成図が作成された。

感想

ちょっと見づらいが、一応構成図としては成立している。
だが、業務でお客さんに見せる際は人間の手が入ることになると思う。もっと見やすい構成図にするためにはどうしたらよいのかはもう少し検証が必要だと思う。
ただ、アイデアだしなどにはよいかな。

追加で作成

Qへの指示

> web3層の構成図を作成して。AWSのベストプラクティスに基づいた構成としたいです。

Qの出力

aws_web_3tier_architecture.png

aws_web_3tier_detailed.png

aws_web_3tier_security.png