Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Reason given by maintainers: Superceeded by diagram agent skill in the deploy-on-aws plugin https://github.com/awslabs/agent-plugins/tree/main/plugins/deploy-on-aws

AWS Diagram MCP Server

Model Context Protocol (MCP) server for AWS Diagrams

This MCP server that seamlessly creates diagrams using the Python diagrams package DSL. This server allows you to generate AWS diagrams, sequence diagrams, flow diagrams, and class diagrams using Python code.

Prerequisites

Install uv from Astral or the GitHub README
Install Python using uv python install 3.10
Install GraphViz https://www.graphviz.org/

Installation

Here are some ways you can work with MCP across AWS, and we'll be adding support to more products including Amazon Q Developer CLI soon: (e.g. for Amazon Q Developer CLI MCP, ~/.aws/amazonq/mcp.json):

{
  "mcpServers": {
    "awslabs.aws-diagram-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-diagram-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "autoApprove": [],
      "disabled": false
    }
  }
}

Features

The Diagrams MCP Server provides the following capabilities:

Generate Diagrams: Create professional diagrams using Python code
Multiple Diagram Types: Support for AWS architecture, sequence diagrams, flow charts, class diagrams, and more
Customization: Customize diagram appearance, layout, and styling
Security: Code scanning to ensure secure diagram generation

Development

Testing

The project includes a comprehensive test suite to ensure the functionality of the MCP server. The tests are organized by module and cover all aspects of the server's functionality.

To run the tests, use the provided script:

./run_tests.sh

This script will automatically install pytest and its dependencies if they're not already installed.

Or run pytest directly (if you have pytest installed):

pytest -xvs tests/

To run with coverage:

pytest --cov=awslabs.aws_diagram_mcp_server --cov-report=term-missing tests/

For more information about the tests, see the tests README.

Development Dependencies

To set up the development environment, install the development dependencies:

uv pip install -e ".[dev]"

This will install the required dependencies for development, including pytest, pytest-asyncio, and pytest-cov.

Release files for awslabs.aws-diagram-mcp-server 0.8.2025141004

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for awslabs.aws-diagram-mcp-server 0.8.2025141004
File	Size	Uploaded
awslabs_aws_diagram_mcp_server-0.8.2025141004.tar.gz	62.6 kB	Apr 14, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for awslabs.aws-diagram-mcp-server 0.8.2025141004
File	Interpreter	ABI	Platform	Reset
awslabs_aws_diagram_mcp_server-0.8.2025141004-py3-none-any.whl 23.5 kB Apr 14, 2025	Python 3	none	any	Details

Total release size:86.1 kB

Release files / awslabs_aws_diagram_mcp_server-0.8.2025141004.tar.gz

Download URL	awslabs_aws_diagram_mcp_server-0.8.2025141004.tar.gz
Size	62.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`8583018732db5e416c2fef99432f3f38beec4d59a038b31d854f82a0a797159e`
BLAKE2b-256 checksum How to use checksums	`79ad9c8c12c349d59037d82421b7074e2b638defc34efffcbdbfae7b0a033c3f`
Upload date	Apr 14, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/awslabs/mcp
Publishing commit: github.com/awslabs/mcp/tree/924451f2bea4997e9831057e629a448b7818937f

Workflow

Publishing configuration: github.com/awslabs/mcp/blob/924451f2bea4997e9831057e629a448b7818937f/.github/workflows/release.yml
Publishing logs: github.com/awslabs/mcp/actions/runs/14442929138/attempts/1

Artifact

Subject: awslabs_aws_diagram_mcp_server-0.8.2025141004.tar.gz
SHA-256 checksum: 8583018732db5e416c2fef99432f3f38beec4d59a038b31d854f82a0a797159e Verifying attestations

Release files / awslabs_aws_diagram_mcp_server-0.8.2025141004-py3-none-any.whl

Download URL	awslabs_aws_diagram_mcp_server-0.8.2025141004-py3-none-any.whl
Size	23.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`047f0c9ed8ec015c040c25a6322788732033bed018b87f14f9d92c475368da02`
BLAKE2b-256 checksum How to use checksums	`ca4d2fa49a336660b72560241a3e31bcda3f47da383327b4e787eb4b45d4ecc0`
Upload date	Apr 14, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/awslabs/mcp
Publishing commit: github.com/awslabs/mcp/tree/924451f2bea4997e9831057e629a448b7818937f

Workflow

Publishing configuration: github.com/awslabs/mcp/blob/924451f2bea4997e9831057e629a448b7818937f/.github/workflows/release.yml
Publishing logs: github.com/awslabs/mcp/actions/runs/14442929138/attempts/1

Artifact

Subject: awslabs_aws_diagram_mcp_server-0.8.2025141004-py3-none-any.whl
SHA-256 checksum: 047f0c9ed8ec015c040c25a6322788732033bed018b87f14f9d92c475368da02 Verifying attestations