AWS Diagram

Provides an MCP server that generates diagrams from Python diagrams DSL, supporting AWS diagrams, sequences, flows, and class diagrams.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "lukeburciu-aws-diagrams-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/lukeburciu/aws-diagrams-mcp-server@main",
        "aws-diagram-mcp-server"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

You can generate a variety of diagrams directly from code using the AWS Diagram MCP Server. It uses the Python diagrams DSL to create AWS architectures, sequence diagrams, flow charts, and class diagrams, making it easy to render complex designs programmatically and reproduce them consistently.

How to use

Set up your MCP client to connect to the AWS Diagram MCP Server via a local process. You will run a local MCP adapter that launches the AWS Diagram MCP Server and communicates through standard input/output. This enables you to generate diagrams by writing Python code that describes the diagram structure.

How to install

Prerequisites you need to prepare before running the MCP server are:

Install uv from Astral or the provided installer path.

Install Python using the following command: uv python install 3.10

Install GraphViz to render diagrams, from https://www.graphviz.org/ or your preferred package manager.

{
  "mcpServers": {
    "aws_diag_mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/lukeburciu/aws-diagrams-mcp-server@main",
        "aws-diagram-mcp-server"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "autoApprove": [],
      "disabled": false
    }
  }
}

Additional sections

Security considerations: The server includes a code-scanning step to help ensure that generated diagrams are produced safely and securely.

Examples: You can generate a variety of diagram types including AWS architecture diagrams, sequence diagrams, flow diagrams, and class diagrams using Python code with the diagrams package.

Development notes: The server includes a comprehensive test suite and can be exercised with the provided test commands to verify functionality and coverage.

Available tools

Generate Diagrams

Create diagrams from Python code using the diagrams DSL to illustrate architectures, workflows, and data relationships.

Multiple Diagram Types

Support for AWS architecture diagrams, sequence diagrams, flow charts, class diagrams, and more.

Customization

Tune diagram appearance, layout, and styling to fit your needs.

Security

Includes code scanning to help ensure diagrams are generated securely.