Skip to content
MCP server

AIGUI

Let a coding agent draw charts, diagrams, 3D scenes, molecules and topologies

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.49.0
Listing updated
1 day ago

About AIGUI

AIGUI is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

The agent never writes drawing code. It writes a small JSON or Mermaid block saying what to show, and AIGUI computes the layout. Output is a PNG the agent can inspect or a live browser page you can comment on. There are 21 block types, nine rendering directly to PNG, including ECharts, Mermaid, KaTeX, dashboards, molecules from SMILES, orbits and topologies whose steps play.

Trust features: chart numbers are read from CSV, TSV or JSON files, never retyped by the model; a headless browser checks overlapping, clipped or low-contrast text; and a topology tool draws docker-compose files and Kubernetes manifests. Pages export to PNG, PDF, single-file HTML or GIF.

It is MIT licensed, needs no account or key and runs locally. Node.js 18.11+ is required, and the first drawing downloads about 100 MB of headless browser.

Install

Run in a terminal

claude mcp add aigui -- npx -y @ai-gui/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "aigui": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-gui/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "aigui": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-gui/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "aigui": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ai-gui/mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "aigui": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-gui/mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "aigui": {
      "command": "npx",
      "args": [
        "-y",
        "@ai-gui/mcp"
      ]
    }
  }
}

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

aigui_guide
List blocks or return exact syntax
aigui_render
Draw blocks in markdown as PNGs
aigui_open
Open the answer as a live page
aigui_edit
Change part of a page by find-and-replace
aigui_export
Save a page as PNG, PDF, HTML, GIF or WebM
aigui_topology
Draw a system from docker-compose or Kubernetes manifests
aigui_feedback
Read comments left on a page's blocks

What it does

21 block types
Charts, diagrams, maths, 3D, molecules, orbits, dashboards.
Data from files
Numbers come from your CSV or JSON.
Self-checking
Flags overlaps, cut-off text and poor contrast.
Topology from config
Draws docker-compose and Kubernetes.
Exports
PNG, PDF, offline HTML, GIF.

Good for

  • Draw a database failover as a stepped topology
  • Chart a CSV without retyping figures
  • Render a molecule from SMILES
  • Produce a dashboard from project data

Pricing

Open source

MIT licensed, no account or key

Prices change. Check liliang-cn.github.io before you buy.

AIGUI FAQ

Is it free?

Yes, MIT with no account or key.

What does it need?

Node.js 18.11+ and a roughly 100 MB headless browser download.

Which agents?

Claude Code and Codex plugins, or any MCP client over stdio.

Where are files saved?

Under ~/.cache/aigui.

Is AIGUI free?

Yes. AIGUI is open source, so you can use and self-host it for free.

How do I add AIGUI to Claude Code?

Run this command in your terminal: claude mcp add aigui -- npx -y @ai-gui/mcp

What are the best alternatives to AIGUI?

The closest alternatives to AIGUI are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to AIGUI

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory