💡

[Kiro + CDK + draw.io] CloudFormationテンプレートから構成図を書く

に公開

背景

  • CDK のビルド生成物である CloudFormation テンプレートからAWSの構成図を書きたい
  • draw.io のMCPサーバーがリリースされたので Kiro CLI に丸投げでいけるのではと考えた

結果

(ほぼ)いけた

手順

MCPサーバーの設定

多分あった方がいいだろうなと思い、AWS Knowledge MCP Server も追加している。

mcp.json
{
  "mcpServers": {
    "aws-knowledge-mcp-server": {
      "url": "https://knowledge-mcp.global.api.aws",
      "type": "http",
      "disabled": false
    },
    "drawio": {
      "command": "npx",
      "args": ["-y", "@drawio/mcp"]
    }
  }
}

CDK ビルド

  • cdk init sample-app --language typescript からの cdk ls でサクッと準備

Kiro CLI に指示

プロンプト
~/work/cdk-drawio/cdk.out/CdkDrawioStack.template.json を読み込んで draw.io で構成図を作成して
kiro
> ~/work/cdk-drawio/cdk.out/CdkDrawioStack.template.json を読み込んで draw.io で構成図を作成して

> CloudFormationテンプレートを読み込んで、draw.ioで構成図を作成します。
Reading file: /home/keita/work/cdk-drawio/cdk.out/CdkDrawioStack.template.json, all lines (using tool: read)
 ✓ Successfully read 6987 bytes from /home/keita/work/cdk-drawio/cdk.out/CdkDrawioStack.template.json
 - Completed in 0.0s

> CloudFormationテンプレートから構成図を作成します。このスタックにはSNSトピックとSQSキューがあり、SNSからSQSへのサブスクリプションが設定さ
れています。
Running tool open_drawio_xml with the param (from mcp server: drawio)
 ⋮  {
 ⋮    "content": "<mxfile host=\"app.diagrams.net\">\n 略 </mxfile>"
 ⋮  }

Allow this action? Use 't' to trust (always allow) this tool for the session. [y/n/t]:

> y

 - Completed in 0.15s

> 構成図を作成しました。このCloudFormationスタックには以下のリソースが含まれています:

- **SNS Topic** (CdkDrawioTopic): メッセージを発行するトピック
- **SQS Queue** (CdkDrawioQueue): メッセージを受信するキュー (VisibilityTimeout: 300秒)
- **SNS Subscription**: SNSトピックからSQSキューへのサブスクリプション
- **Queue Policy**: SNSがSQSにメッセージを送信できるようにするポリシー

draw.ioエディタがブラウザで開かれ、編集可能な状態になっています。

 ▸ Credits: 0.45 • Time: 1m 53s

まとめ

  • さくっとできた
  • SQL Queue の VisibilityTimeout の値とかは要らないので、CloudFormation上のどのプロパティを使うか(あるいは使わないか)を蓄積していけば、より求める成果物に近づけることができそう

Discussion