# Arc

Arc lets an AI agent create, validate, arrange, compare, and export architecture diagrams. Connect it when you want diagram work available through MCP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 17 repo stars
- Author: hudsonkit
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hudsonkit/arc/tree/HEAD/packages/mcp
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/arc

## What it does

Arc exposes tools for building diagrams, checking them, arranging nodes, and finding structural changes between versions. It can produce SVG, HTML, terminal art, or a typed TypeScript module. PNG output relies on a local Chrome or Chromium binary; animated exports also need ffmpeg.

The server runs over stdio with `npx -y @hudsonkit/arc-mcp` and requires Node.js 22 or newer. Live-diagram tools open a session and publish complete, validated revisions to its view. In stdio mode, keep the MCP process active and use the view from that same computer.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add arc -- npx -y @hudsonkit/arc-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp -- npx -y @hudsonkit/arc-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@hudsonkit/arc-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@hudsonkit/arc-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp npx -y @hudsonkit/arc-mcp
```

## When to use it
- author an architecture diagram as code
- validate a diagram and apply a supported fix
- arrange diagram nodes and connectors automatically
- compare two diagram revisions
- export a diagram as SVG, PNG, or HTML

## Example prompts
- Create an architecture diagram for this service and validate it.
- Compare the current diagram with this revision and show the structural changes.
- Export the diagram as PNG using the local Chrome installation.

## Similar
- [arc-region-switch](https://affpapa.org/en/nevibecode/skills/arc-region-switch.md) — skill · 4700 installs
- [use-arc](https://affpapa.org/en/nevibecode/skills/use-arc.md) — skill · 1100 installs
- [character-arc](https://affpapa.org/en/nevibecode/skills/character-arc.md) — skill · 645 installs
- [arc-mastery](https://affpapa.org/en/nevibecode/skills/arc-mastery.md) — skill · 615 installs
- [azure-arc](https://affpapa.org/en/nevibecode/skills/azure-arc.md) — skill · 185 installs
- [Arc UI](https://affpapa.org/en/nevibecode/mcp/arc-ui.md) — MCP server · ★ 1338 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
