Q CLI Aws Diagram MCP

为Amazon Q CLI设置AWS图表MCP服务器

本指南提供了安装和配置AWS Diagram MCP服务器以与Amazon Q CLI一起使用的分步说明。

先决条件

1. Linux 操作系统
2. Python 3.10或更高版本
3. pip包管理器
4. GraphViz（生成图表所需）

安装方法

您可以使用自动脚本或按照手动安装步骤安装AWS Diagram MCP服务器。

选项1：自动安装脚本（推荐）

为了轻松安装，您可以使用我们的自动安装脚本：

# Download the installation script
curl -O https://raw.githubusercontent.com/Ssri7774/q-cli-aws-diagram-mcp/main/docs/aws-diagram-mcp/install_aws_diagram_mcp.sh

# Make it executable
chmod +x install_aws_diagram_mcp.sh

# Run the script
./install_aws_diagram_mcp.sh

脚本将：

• 检查先决条件
• 安装GraphViz
• 安装所需的Python包
• 创建和配置MCP配置文件
• 验证安装

脚本功能

• 检测系统的包管理器（apt、yum、dnf、brew）
• 提供彩色输出以提高可读性
• 验证安装的每个步骤
• 适用于各种Linux发行版和macOS
• 提供清晰的错误消息和故障排除指导

选项2：手动安装步骤

如果您更喜欢手动安装或需要对安装过程进行更多控制，请按照以下步骤操作：

1.安装GraphViz

生成图表需要GraphViz。使用系统的包管理器安装它：

sudo apt-get update && sudo apt-get install -y graphviz

有关其他操作系统，请参阅 GraphViz下载页面.

2.安装所需的Python包

安装必要的Python包：

# Install the diagrams package
pip install diagrams

# Install the MCP tools
pip install fastmcp uvx

# Install the AWS Diagram MCP Server
pip install awslabs.aws-diagram-mcp-server

3.创建MCP配置目录

为Amazon Q CLI配置创建目录结构：

mkdir -p ~/.aws/amazonq

4.创建MCP配置文件

在以下位置创建MCP配置文件 ~/.aws/amazonq/mcp.json 内容如下：

cat > ~/.aws/amazonq/mcp.json << 'EOF'
{
  "mcpServers": {
    "awslabs.aws-diagram-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-diagram-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "autoApprove": [],
      "disabled": false
    }
  }
}
EOF

验证

要验证AWS Diagram MCP服务器是否已正确安装和配置：

1. 启动Amazon Q CLI：

   q chat

1. 让亚马逊Q创建一个简单的图表：

   Create a simple AWS architecture diagram with an EC2 instance and an S3 bucket

1. Amazon Q应使用AWS图表MCP服务器生成图表。

故障排除

常见问题

1. GraphViz未找到错误:

- 错误： graphviz.backend.execute.ExecutableNotFound: failed to execute PosixPath('dot') - 解决方案：使用系统的包管理器安装GraphViz。

1. Python版本问题:

- 错误：包不兼容消息 - 解决方案：确保你使用的是Python 3.10或更高版本。与核对 python3 --version.

1. 权限问题:

- 错误：创建目录或文件时权限被拒绝 - 解决方案：使用 sudo 用于系统范围的安装，或确保用户目录的适当权限。

1. 未检测到MCP服务器:

- 问题：Amazon Q不使用图表功能 - 解决方案：验证MCP配置文件路径和内容。重新启动Amazon Q CLI。

其他配置选项

使用Docker（替代方法）

如果你更喜欢使用Docker，你可以配置MCP服务器在容器中运行：

{
  "mcpServers": {
    "awslabs.aws-diagram-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--interactive",
        "--env",
        "FASTMCP_LOG_LEVEL=ERROR",
        "awslabs/aws-diagram-mcp-server:latest"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

注意：这需要先构建或拉取Docker镜像。

调整日志级别

您可以通过修改日志级别来更改 FASTMCP_LOG_LEVEL 配置文件中的环境变量。可用选项包括：

• ERROR （默认）
• WARNING
• INFO
• DEBUG

资源

• AWS MCP文档
• 图表Python包
• GraphViz文档

此设置使Amazon Q能够使用Python代码创建各种类型的图表，包括AWS架构图、序列图、流程图和类图。