fast-html-mcp

Four-tier MCP server for lightning-fast HTML generation from AI agents - assembly, patch, read, and raw tiers with 9 tools

GitHub

Fast HTML MCP

npm version CI License Node 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

TierToolDescription
Assemblyrender_pageCompose pages from structured component specs using templates
Patchpatch_htmlReplace inner content of matched elements via CSS selectors
Patchset_attributeSet an attribute on matched elements
Readread_htmlAnalyze existing HTML files (structure, content, compressed modes)
Rawwrite_raw_htmlWrite raw HTML string to file
Rawwrite_html_fileAlias for write_raw_html
Rawformat_htmlBeautify an existing HTML file in-place
Rawpreview_htmlRender HTML string to preview file
Utilitylist_componentsList available components with props
Utilitylist_templatesList 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.

Related Servers