I Built an AI Agent That Converts Natural Language to Architecture Diagrams — Here's How It Works

#ai #opensource #drawio #mcp

I've been frustrated with drawing architecture diagrams manually. Every time I need to document a system, I open draw.io and drag boxes for 20 minutes. So I built an AI agent that does it for me — from a text description.

The Core Idea

You type: "AWS architecture with ECS, RDS, ElastiCache, and API Gateway"

You get a complete draw.io diagram, with the right shapes, labels, and layout — in about 30 seconds.

The agent loop:

User Request → Plan → Generate draw.io XML → Semantic Verification → Self-Correct (if needed) → Render

The Secret Sauce: Semantic Verification

Most AI diagram tools are black boxes — you don't know if the output actually matches what you asked for. This system programmatically verifies the generated diagram by checking if all requested components are present in the XML output.

If a component is missing → it self-corrects and regenerates.

MCP Integration

The MCP (Model Context Protocol) server is the feature I'm most excited about. It means Claude Desktop can generate diagrams on demand, directly from conversation. No UI needed.