HTML Deploy Server

FreeNot checked

Deploys HTML pages to an online preview platform and returns a shareable URL via MCP protocol.

by luler

GitHub Embed

About

Deploys HTML pages to an online preview platform and returns a shareable URL via MCP protocol.

README

一个基于 FastAPI 的 MCP 服务器，可将 HTML 页面代码一键部署到在线预览平台，返回可访问的 URL。

✨ 功能

🚀 一键部署 HTML 页面到在线服务器
🔗 返回可直接访问的预览链接
🤖 支持 MCP 协议，可与 Claude、Cursor 等 AI 工具集成

📋 环境要求

Python 3.12+

🛠️ 安装

# 克隆项目
git clone https://github.com/luler/hello_project_mcp.git
cd hello_project_mcp

# 安装依赖
pip install -r requirements.txt

🚀 启动服务

python main.py

服务将在 http://localhost:8989 启动。

📡 MCP 端点

端点	协议	用途
`http://localhost:8989/mcp`	HTTP	Streamable HTTP 传输
`http://localhost:8989/sse`	SSE	Server-Sent Events 传输

🔧 配置 MCP 客户端

Claude Desktop

编辑配置文件：

{
  "mcpServers": {
    "html-deploy": {
      "url": "http://localhost:8989/sse"
    }
  }
}

Cursor

在 Cursor 设置中添加 MCP 服务器：

{
  "mcpServers": {
    "html-deploy": {
      "url": "http://localhost:8989/sse"
    }
  }
}

Cherry Studio / 其他客户端

使用 SSE 端点：http://localhost:8989/sse

💬 使用示例

配置完成后，在 AI 对话中可以这样使用：

帮我做一个贪吃蛇游戏，用 deploy_html 部署，给我链接

创建一个渐变背景的登录页面，然后部署上线

写一个动态时钟页面，deploy_html 发布一下

AI 会自动生成 HTML 代码并调用 deploy_html 工具进行部署，返回预览链接。

📖 API 文档

启动服务后访问：

Swagger UI: http://localhost:8989/docs
ReDoc: http://localhost:8989/redoc

deploy_html

部署 HTML 页面到预览服务器。

请求：

{
  "html": "<!DOCTYPE html><html>...</html>"
}

响应：

{
  "success": true,
  "message": "HTML打包并上传成功",
  "preview_url": "https://html.luler.top/preview/xxxxx"
}

⚙️ 配置说明

通过环境变量或 .env 文件配置：

UPLOAD_PLATFORM_BASE_URL=https://html.luler.top  # 预览平台地址
UPLOAD_CODE=1dec7206c6  # 项目标识
PORT=8989  # 服务端口
DEBUG=0  # 调试模式（1为开启热重载）

from github.com/luler/hello_project_mcp

Installing HTML Deploy Server

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/luler/hello_project_mcp

FAQ

Is HTML Deploy Server MCP free?

Yes, HTML Deploy Server MCP is free — one-click install via Unyly at no cost.

Does HTML Deploy Server need an API key?

No, HTML Deploy Server runs without API keys or environment variables.

Is HTML Deploy Server hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install HTML Deploy Server in Claude Desktop, Claude Code or Cursor?

Open HTML Deploy Server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.