[!Предупреждение] ** Pre-Release Alpha Software**: Это программное обеспечение находится на ранней стадии разработки и может содержать дефекты. Пожалуйста, откройте вопросы на github.com/aws-samples/sample-drawio-mcp/issues — мы приветствуем сообщения об ошибках и принимаем PR.

Создавайте, читайте и обновляйте диаграммы draw.io программно с помощью помощников ИИ.

###Что это такое?

MCP-сервер draw.io позволяет помощникам ИИ создавать технические диаграммы на локальном компьютере с помощью естественного языка. Попросите диаграмму архитектуры AWS, блок-схему или топологию сети — и посмотрите, как она отображается в формате draw.io.

️ Архитектура

Проект состоит из двух основных компонентов:

DrawIO JSAPI - библиотека JavaScript/TypeScript, которая манипулирует структурами XML mxGraph MCP Server - Сервер протокола Model Context Protocol, который предоставляет графические операции помощникам ИИ

JSAPI работает независимо от зависимостей среды выполнения draw.io или mxGraph, работая как в Node.js, так и в браузерных средах.

Privacy Конфиденциальность

Все операции выполняются полностью на вашей локальной машине. Данные диаграмм, телеметрия или информация не передаются по сети.

Ключевые особенности

🎨 Draw.io MCP Server

[!WARNING] Pre-Release Alpha Software: This software is in an early stage of development and may contain defects. Please open issues at github.com/aws-samples/sample-drawio-mcp/issues — we welcome bug reports and accept PRs.

Create, read, and update draw.io diagrams programmatically using AI assistants.

🚀 What is This?

The draw.io MCP server enables AI assistants to build technical diagrams on your local computer through natural language. Ask for an AWS architecture diagram, a flowchart, or a network topology—and watch it appear in draw.io format.

🏗️ Architecture

The project consists of two main components:

• DrawIO JSAPI - A JavaScript/TypeScript library that manipulates mxGraph XML structures
• MCP Server - A Model Context Protocol server that exposes diagram operations to AI assistants

The JSAPI operates independently of draw.io or mxGraph runtime dependencies, working in both Node.js and browser environments.

🔒 Privacy First

All operations run entirely on your local machine. No diagram data, telemetry, or information is transmitted over the network.

✨ Key Features

• 📊 Create architecture diagrams with AWS, Kubernetes, and more icons!
• 🔄 Programmatically modify existing diagrams
• 🎯 Natural language diagram creation through AI assistants
• 🌐 Works in Node.js and browser environments
• 🔐 100% local operation with no network dependencies

🎯 Quick Example

You: "Create an AWS serverless architecture diagram with CloudFront, API Gateway,
container-based Lambda (pulling from ECR), connecting to Aurora PostgreSQL,
OpenSearch, S3, and Bedrock. Include Cognito for authentication, IAM roles,
and CodePipeline for deployment. Show the VPC and private subnet structure."

AI: [Generates a properly formatted draw.io diagram with official AWS icons]

Example AWS architecture diagram generated by the MCP server. The resulting .drawio file can be edited manually in draw.io or programmatically by AI assistants like Kiro.

Getting Started

MCP Client Configuration

Add to your MCP client config (Claude Desktop, Claude Code, Kiro):

{
  "mcpServers": {
    "drawio": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/aws-samples/sample-drawio-mcp/releases/latest/download/drawio-mcp-server-latest.tgz",
        "--no-cache"
      ],
      "type": "stdio"
    }
  }
}

See the full Installation Guide for version pinning, platform-specific config paths, and building from source.

📚 Documentation

• JSAPI - JavaScript API documentation for programmatic diagram creation