MCP.so
Sign In

MCP HTML Sync Server

@yujiosaka

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

yujiosaka

About MCP HTML Sync Server

A real-time HTML syncing server with hot reload capabilities, built using the Model Context Protocol (MCP)

MCP HTML Sync Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-html-sync-server": {
      "command": "docker",
      "args": [
        "pull",
        "yujiosaka/mcp-html-sync-server"
      ]
    }
  }
}

MCP HTML Sync Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP HTML Sync Server?

MCP HTML Sync Server is a real-time HTML syncing server with hot reload capabilities, built using the Model Context Protocol (MCP). It enables AI agents to create, update, and destroy HTML pages dynamically, with all connected clients receiving updates in real-time.

How to use MCP HTML Sync Server?

Install via Docker (docker pull yujiosaka/mcp-html-sync-server), npx (npx mcp-html-sync-server), or from source. Configure using environment variables or a .env file (SERVER_HOST, SERVER_PORT, BASE_URL, PAGE_MAX_AGE, PAGE_MAX_COUNT). Integrate with Claude Desktop or VS Code by adding an MCP server entry to their configuration JSON, and invoke the server’s tools (create_page, update_page, destroy_page) from an AI agent.

Key features of MCP HTML Sync Server

  • Real-time HTML syncing with instant client updates
  • WebSocket hot reload for connected browsers
  • Script management via CDN URLs or inline content
  • Stylesheet management via CDN URLs
  • Built for AI agents using the Model Context Protocol
  • Automatic page expiration after configurable time
  • Configurable maximum page count with cleanup of oldest pages
  • Lightweight with minimal dependencies

Use cases of MCP HTML Sync Server

  • AI agents creating and previewing dynamic HTML pages in real time
  • Adding JavaScript and CSS to pages for interactive demos or prototypes
  • Collaborative editing where content updates are instantly reflected in all clients
  • Hot-reloading web pages during development without manual refresh

Frequently asked questions

1

How do I install MCP HTML Sync Server?

Install via Docker (`docker pull yujiosaka/mcp-html-sync-server`), npx (`npx mcp-html-sync-server`), or by cloning the repository and using `bun install` then `bun run start`.

2

What configuration options are available?

Configure via environment variables or a `.env` file: `SERVER_HOST` (default localhost), `SERVER_PORT` (default 3000), `BASE_URL` (default http://localhost:3000/), `PAGE_MAX_AGE` (default 1h), and `PAGE_MAX_COUNT` (default 1000).

3

What MCP tools does the server provide?

Three tools: `create_page` (creates a new HTML page with optional scripts and stylesheets), `update_page` (updates an existing page’s body), and `destroy_page` (removes a page and disconnects all clients).

4

How does page expiration and limit work?

Pages have a configurable maximum age (`PAGE_MAX_AGE`, e.g., 1h). When the total number of pages exceeds `PAGE_MAX_COUNT`, the oldest pages are automatically removed.

5

Does the server support real-time updates?

Yes. When a page is created or updated, all connected browsers receive updates in real-time via WebSocket hot reload.

Comments

More Other MCP servers