🚀 在GitHub Codespace中使用Amazon Q CLI和MCP服务器加速AWS架构图绘制
此存储库显示了如何设置 Amazon Q开发者命令行界面 内部a GitHub代码空间，将其与AWS MCP服务器连接以绘制架构图，并使用AI辅助提示生成高质量的AWS架构图。
______________________________________________________________________
📦 1.在GitHub Codespace中安装Amazon Q Developer CLI
Codespace容器是一个 基于Ubuntu的Linux虚拟机，所以我们可以遵循亚马逊Q的标准Linux（无头）安装。
______________________________________________________________________
1.️⃣ 打开代码空间终端
在浏览器中，按 控制键 + 移动 + \`\ 或前往 终端→ 新建航站楼.
______________________________________________________________________
2.️⃣ 安装所需的实用程序
sudo apt-get update
sudo apt-get install -y unzip curl______________________________________________________________________
3.️⃣ 下载最新无头版本
curl --proto '=https' --tlsv1.2 -sSf \
https://desktop-release.codewhisperer.us-east-1.amazonaws.com/latest/q-x86_64-linux-musl.zip \
-o /tmp/q.zip______________________________________________________________________
4.️⃣ 打开包装并运行安装程序
cd /tmp
unzip q.zip
chmod +x q/install.sh
./q/install.sh出现提示时：
- 将Amazon Q添加到shell的PATH中？ → Type
y - 登录方式？ → 选择 免费使用Builder ID 并完成浏览器登录。
______________________________________________________________________
💬 2.开始亚马逊Q聊天
安装后，启动交互式Amazon Q会话：
q chat在聊天中，提供以下初始上下文以设置MCP服务器：
I want to setup AWS diagram MCP server. Execute these steps:
1. Install Python 3.10
2. Install AWS Diagram MCP server package from here: https://awslabs.github.io/mcp/servers/aws-diagram-mcp-server/
3. Install AWS Documentation MCP server package from here: https://awslabs.github.io/mcp/servers/aws.documentation-mcp-server/
4. Create necessary MCP configuration files at ~/.aws/amazonq/mcp.json______________________________________________________________________
🔄 3.重新启动亚马逊问答验证MCP工具
要重新启动亚马逊Q：
/quit
q chat当Amazon Q重新启动时，它应该显示如下MCP服务器：
✅ 预期：
awslabs.aws-diagram-mcp-server装载的awslabs.aws-documentation-mcp-server装载的
⚠ 如果工具无法加载，请向Amazon Q提供以下JSON：
{
"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
}
}
}并将其添加到：
~/.aws/amazonq/mcp.json______________________________________________________________________
🖼 4.生成AWS架构图
第一步——准备一份高质量的提示
使用任何AI聊天机器人(ChatGPT, 双子座, 困惑度等等）来细化您的架构请求。 从以下内容开始：
I need to create a prompt that...包括：
- 需求 （例如，无服务器、多区域、安全）
- 流动 （例如，用户→ API网关→ 拉姆达→ DynamoDB）
- 逻辑组件
- 约束条件
目标是让人工智能生成 清晰、详细、准确 提示。
______________________________________________________________________
第二步——向亚马逊Q发送提示
将最后的提示粘贴到里面 q chat.
亚马逊Q将：
- 生成一个
.png图表 里面generated-diagrams文件夹。 - 提供a 图表说明 在终端。
______________________________________________________________________
步骤3——查看图表
在您的代码空间中，打开 generated-diagrams 文件夹以查看AWS架构图。 您可以直接在GitHub Codespace中预览它。
______________________________________________________________________
📚 参考文献
______________________________________________________________________
现在，您已经准备好使用Amazon Q直接从GitHub代码空间创建清晰、精确的AWS架构图！