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

⚠️ DEPRECATION NOTICE: This server is deprecated and will no longer receive updates. Please use the diagram agent skill in the deploy-on-aws plugin instead, which generates equivalent diagrams directly through Claude Code without requiring a running MCP server. See the migration guide for step-by-step instructions.

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

Kiro	Cursor	VS Code

Configure the MCP server in your MCP client configuration (e.g., for Kiro, edit ~/.kiro/settings/mcp.json):

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

Windows Installation

For Windows users, the MCP server configuration format is slightly different:

{
  "mcpServers": {
    "awslabs.aws-diagram-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.aws-diagram-mcp-server@latest",
        "awslabs.aws-diagram-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

or docker after a successful docker build -t awslabs/aws-diagram-mcp-server .:

  {
    "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": []
      }
    }
  }

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

Quick Example

from diagrams import Diagram
from diagrams.aws.compute import Lambda
from diagrams.aws.database import Dynamodb
from diagrams.aws.network import APIGateway

with Diagram("Serverless Application", show=False):
    api = APIGateway("API Gateway")
    function = Lambda("Function")
    database = Dynamodb("DynamoDB")

    api >> function >> database

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 1.0.23

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 1.0.23
File	Size	Uploaded
awslabs_aws_diagram_mcp_server-1.0.23.tar.gz	110.9 kB	Mar 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for awslabs.aws-diagram-mcp-server 1.0.23
File	Interpreter	ABI	Platform	Reset
awslabs_aws_diagram_mcp_server-1.0.23-py3-none-any.whl 30.2 kB Mar 9, 2026	Python 3	none	any	Details

Total release size: 141.1 kB

Release files / awslabs_aws_diagram_mcp_server-1.0.23.tar.gz

Download URL	awslabs_aws_diagram_mcp_server-1.0.23.tar.gz
Size	110.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`2c8fb1b0e822c1e74e0a8da565de735ce4567bd1b2d2724248e5d0d359cfb152`
BLAKE2b-256 checksum How to use checksums	`8c0199d81d41573841fa4334e771c8faa1fce26796df2a5e4a5e47097ab18e90`
Upload date	Mar 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

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/c9f2d3314e384ab592d2c3912ac81c1a3c201c0c

Workflow

Publishing configuration: github.com/awslabs/mcp/blob/c9f2d3314e384ab592d2c3912ac81c1a3c201c0c/.github/workflows/release.yml
Publishing logs: github.com/awslabs/mcp/actions/runs/22876676767/attempts/1

Artifact

Subject: awslabs_aws_diagram_mcp_server-1.0.23.tar.gz
SHA-256 checksum: 2c8fb1b0e822c1e74e0a8da565de735ce4567bd1b2d2724248e5d0d359cfb152 Verifying attestations

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

Download URL	awslabs_aws_diagram_mcp_server-1.0.23-py3-none-any.whl
Size	30.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7c41228152bc50ae047fa8466f62da7e3075f4c39616734dd5dfb03eaf719fe0`
BLAKE2b-256 checksum How to use checksums	`8bb80384a3d0389bcc5e1969740318ede18a0fd30699c325fc8fdf94161526c6`
Upload date	Mar 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

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

Workflow

Publishing configuration: github.com/awslabs/mcp/blob/c9f2d3314e384ab592d2c3912ac81c1a3c201c0c/.github/workflows/release.yml
Publishing logs: github.com/awslabs/mcp/actions/runs/22876676767/attempts/1

Artifact

Subject: awslabs_aws_diagram_mcp_server-1.0.23-py3-none-any.whl
SHA-256 checksum: 7c41228152bc50ae047fa8466f62da7e3075f4c39616734dd5dfb03eaf719fe0 Verifying attestations