Skip to content
MCP server

Archform

MCP server that renders and validates diagrams as code, from Mermaid to BPMN

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.2
Listing updated
today

Similar MCP servers

About Archform

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

Archform gives an assistant three read-only tools: list the supported formats, render a diagram and validate its source. Eight formats are covered: Mermaid, PlantUML, C4-PlantUML, Graphviz, D2, Structurizr, BPMN and Excalidraw. Rendering returns SVG or PNG plus a shareable link; invalid source returns the parser message and line.

Rendering is done by Kroki, and by default diagram source is sent to the public kroki.io service. The README advises self-hosting Kroki and setting KROKI_URL if diagrams are sensitive, and includes a docker-compose example.

It runs locally over stdio for Claude Desktop, Claude Code, Cursor and VS Code, or as a stateless Streamable HTTP endpoint for ChatGPT developer mode. The HTTP mode binds to localhost by default, has DNS-rebinding protection and rate limits tool calls; source is capped at 100 KB. It needs Node.js 22 or later and is MIT-licensed.

Install

Run in a terminal

claude mcp add archform -- npx -y @archform/mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • KROKI_URLKroki server used for rendering. Defaults to the public https://kroki.io; set it to a self-hosted instance to keep diagram source private.

Tools this server provides (3)

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

list_formats
Lists supported formats with aliases, outputs and examples
render_diagram
Renders diagram source to SVG or PNG with a share link
validate_diagram
Checks source and returns errors with line numbers

What it does

Eight diagram formats
Mermaid, PlantUML, C4, Graphviz, D2, Structurizr, BPMN and Excalidraw.
Render to image
Produces SVG or PNG and a shareable link.
Validate source
Returns whether a diagram is valid with line-level errors.
Self-hostable rendering
Point KROKI_URL at your own Kroki instance.
Stdio or HTTP
Runs locally or as a stateless remote endpoint.
Rate limits
Configurable overall and per-client limits on tool calls.

Good for

  • Draw a C4 context diagram from a prompt
  • Turn a Prisma schema into an ER diagram
  • Check diagram source for syntax errors
  • Keep diagram source private by self-hosting Kroki

Pricing

Open source

MIT licence

Archform FAQ

Is my diagram source sent anywhere?

By default to the public kroki.io; set KROKI_URL to a self-hosted Kroki to avoid that.

Which formats are supported?

Mermaid, PlantUML, C4-PlantUML, Graphviz, D2, Structurizr, BPMN and Excalidraw.

What are the requirements?

Node.js 22 or later.

Can ChatGPT use it?

Yes, via the HTTP mode as a connector in developer mode with no authentication.

Is Archform free?

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

How do I add Archform to Claude Code?

Run this command in your terminal: claude mcp add archform -- npx -y @archform/mcp

What are the best alternatives to Archform?

The closest alternatives to Archform are REA, HyperFrames by HeyGen, Context7, Chrome DevTools MCP and Codebase Memory.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers