AWS架构图生成工具

带有AWS图表和文档MCP服务器的Docker化Amazon Q CLI

此存储库提供了一个Docker化的设置，用于运行 亚马逊Q CLI 随着：

• AWS图表MCP服务器 (awslabs.aws-diagram-mcp-server)
• AWS文档MCP服务器 (awslabs.aws-documentation-mcp-server)

您可以使用此容器与Amazon Q聊天，并直接从Docker内部生成AWS架构图。

📦 构建Docker镜像

克隆此存储库并构建Docker镜像：

docker build -t amazonq-mcp .

▶️ 运行容器

以交互方式运行容器，为生成的图表挂载一个主机文件夹：

docker run -it --rm -v "$(pwd)/diagram:/workspace/generated-diagrams" amazonq-mcp

说明：

• $(pwd)/diagram → 用于存储生成的图表的主机目录。
• /workspace/generated-diagrams/ → Amazon Q保存图表的容器路径。
• $HOME/.aws:/root/.aws → 装载您的AWS凭据/config，以便Amazon Q CLI可以进行身份验证。

🔑 登录亚马逊Q

在容器内，运行：

q login

按照提示操作：

1. 将打开一个浏览器窗口，用于AWS SSO登录。
2. 选择您的AWS帐户和SSO配置文件。
3. 选择所需的构建ID 当提示时。

💬 开始与亚马逊Q聊天

登录后，开始聊天会话：

q chat

示例提示：

Generate an AWS architecture diagram for a VPC with two subnets, EC2 instance, and RDS.

图表将生成并保存在：

./diagram

（在您的主机上）。

📂 存储库结构

.
├── Dockerfile          # Container build instructions
├── mcp.json            # MCP server configuration
├── README.md           # This documentation
└── diagram/            # Generated diagrams (created automatically)

🛠 备注

• 需要在主机上安装Docker。
• Graphviz已预先安装在容器中，用于图表渲染。