MCP HTML Sync Server

产品定位

MCP HTML Sync Server 是一个专为AI代理设计的实时HTML同步服务器，支持动态创建、更新和销毁HTML页面，并通过WebSocket实现实时热重载。

核心功能

• 实时HTML同步：创建和更新HTML内容，所有连接的客户端即时更新
• WebSocket热重载：内容更改时所有连接的浏览器自动刷新
• 脚本管理：通过CDN URL或内联内容向页面添加JavaScript脚本
• 样式表管理：通过CDN URL向页面添加CSS样式表
• MCP集成：专为使用模型上下文协议的AI代理设计
• 页面生命周期管理：可配置时间后自动过期页面
• 连接限制：可配置最大页面数，自动清理最旧的页面
• 简单API：易于使用的MCP工具，用于页面创建、更新和销毁
• 轻量级：最小依赖和高效资源使用

适用场景

• AI代理动态生成和更新HTML内容
• 实时协作编辑和预览HTML页面
• 快速原型设计和演示
• 教学和培训环境中的实时示例展示

MCP工具列表

1. 创建页面：创建一个新的HTML页面
2. 更新页面：更新现有页面的内容
3. 销毁页面：移除页面并断开所有客户端连接
4. 添加脚本：向现有页面添加JavaScript脚本
5. 添加样式表：向现有页面添加CSS样式表

常见问题解答

• 端口已被占用：如果启动服务器时出现端口被占用的错误，可以更改端口号或停止占用端口的应用程序

使用依赖

• Docker或Node.js环境
• Bun运行时（如果从源代码安装）

安装教程

使用Docker

docker pull yujiosaka/mcp-html-sync-server
docker run -p 3000:3000 yujiosaka/mcp-html-sync-server

使用NPX

NODE_ENV=production npx mcp-html-sync-server

从源代码安装

git clone https://github.com/yujiosaka/mcp-html-sync-server.git
cd mcp-html-sync-server
bun install
bun run config
bun run start

调试方式

运行手动测试脚本

bun manual-test.ts

开发模式

bun run dev

检查端口占用

# On macOS/Linux
lsof -i :3000

# On Windows
netstat -ano | findstr :3000

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。