# AIGUI

> AIGUI is an open-source MCP server for design and media. Let a coding agent draw charts, diagrams, 3D scenes, molecules and topologies. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Website:** https://liliang-cn.github.io/aigui/
- **Repository:** https://github.com/liliang-cn/aigui/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.liliang-cn/aigui
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/aigui
