Fast HTML MCP

Four-tier MCP server for lightning-fast HTML generation from AI agents.
Assembly-Patch-Read-Raw architecture. 9 tools, 15 components, 10 templates.

MCP name: io.github.xdnaimino/fast-html-mcp

Quick Start

npx @surfsense/fast-html-mcp

Or add to your MCP client config:

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

Tools

Tier	Tool	Description
Assembly	render_page	Compose pages from structured component specs using templates
Patch	patch_html	Replace inner content of matched elements via CSS selectors
Patch	set_attribute	Set an attribute on matched elements
Read	read_html	Analyze existing HTML files (structure, content, compressed modes)
Raw	write_raw_html	Write raw HTML string to file
Raw	write_html_file	Alias for write_raw_html
Raw	format_html	Beautify an existing HTML file in-place
Raw	preview_html	Render HTML string to preview file
Utility	list_components	List available components with props
Utility	list_templates	List available templates

Components (15)

Layout: header, footer, sidebar, card-deck, grid
Interactive: tabs, accordion
Data: data-table, stats-grid, timeline
Media: figure, image-gallery
Utility: hero, callout, code-block

Templates (10)

report, exploration, deck, code-review, design, prototyping, illustrations, research, custom-editor, minimal

Architecture

Fast HTML MCP
├── Assembly Tier   — render_page
├── Patch Tier      — patch_html, set_attribute
├── Read Tier       — read_html
├── Raw Tier        — write_raw_html, write_html_file, format_html, preview_html
└── Utilities       — list_components, list_templates

Development

git clone https://github.com/Aimino-Tech/fast-html-mcp.git
cd fast-html-mcp
npm install
npm run build
npm run dev    # hot reload via tsx
npm test       # vitest

License

Apache 2.0 — see LICENSE.