mcp-html-uploader 1.0.0

MCP 服务器 - 提供 HTML 文件创建和文件上传功能

HTML 文件创建和上传 MCP 服务器

这是一个基于 Model Context Protocol (MCP) 的 Python 服务器，提供三个核心功能：

1. 创建 HTML 文件
2. 上传文件到服务器
3. 创建 HTML 文件并立即上传（组合工具）

功能说明

1. create_html - 创建 HTML 文件

根据提供的内容创建格式良好的 HTML 文件，文件名和标题自动生成。

参数：

• content (必需): HTML 文件的主体内容，可以是完整的 HTML 代码或仅内容片段

说明：

• 文件名自动生成格式：page_YYYYMMDD_HHMMSS.html
• 文件保存在当前目录
• 标题默认为"文档"

示例：

{
  "content": "<h1>欢迎</h1><p>这是我的第一个页面</p>"
}

2. upload_file - 上传文件

上传文件到指定的服务器 API 接口，返回文件 URL。

参数：

• file_path (必需): 要上传的文件路径（相对或绝对路径）
• token (必需): API 认证 Token

说明：

• 使用 form-data 格式，字段名固定为 file
• Token 设置在请求头中
• 返回服务器响应中 body.fileUrl 的值

示例：

{
  "file_path": "./page_20260112_143000.html",
  "token": "your-api-token-here"
}

返回示例：

https://example.com/uploads/your-file.html

上传接口：https://v5.kaleido.guru/api/proxyStorage/NoAuth/upload_file

3. create_and_upload_html - 创建并上传 HTML 文件

创建 HTML 文件并立即上传到服务器，一步完成两个操作，返回文件 URL。

参数：

• content (必需): HTML 文件的主体内容，可以是完整的 HTML 代码或仅内容片段
• token (必需): API 认证 Token

说明：

• 文件名自动生成格式：page_YYYYMMDD_HHMMSS.html
• 文件保存在当前目录后立即上传
• 使用 form-data 格式，字段名固定为 file
• Token 设置在请求头中
• 返回服务器响应中 body.fileUrl 的值

示例：

{
  "content": "<h1>欢迎</h1><p>这是我的第一个页面</p>",
  "token": "your-api-token-here"
}

返回示例：

https://example.com/uploads/page_20260112_143000.html

安装

1. 确保已安装 Python 3.10 或更高版本

2. 安装依赖：

pip install -r requirements.txt

配置 MCP 客户端

Claude Desktop 配置

编辑 Claude Desktop 配置文件：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "html-file-server": {
      "command": "python3",
      "args": [
        "/Users/liujingjing/ljj/work/mcp-creat-upload-html/server.py"
      ]
    }
  }
}

注意：将路径替换为你的实际项目路径。

运行

MCP 服务器通过标准输入/输出 (stdio) 与客户端通信，通常由 MCP 客户端（如 Claude Desktop）自动启动。

你也可以手动测试服务器：

python3 server.py

使用示例

创建 HTML 文件

创建简单的 HTML 页面：

请使用 create_html 工具创建一个 HTML 文件，内容是"<h1>你好世界</h1>"

上传文件

请使用 upload_file 工具将 page_20260112_143000.html 文件上传到服务器，token 是 xxx

创建并上传 HTML 文件（一步完成，推荐）

请创建一个包含"<h1>欢迎来到我的网站</h1><p>这是首页内容</p>"的 HTML 页面并立即上传到服务器，token 是 xxx

这个工具会：

1. 自动生成文件名（例如：page_20260112_143000.html）
2. 创建完整的 HTML 文件
3. 立即上传到服务器
4. 返回文件 URL

项目结构

mcp-creat-upload-html/
├── server.py          # MCP 服务器主文件
├── requirements.txt   # Python 依赖
└── README.md         # 项目说明文档

技术栈

• Python 3.10+
• MCP (Model Context Protocol) SDK
• httpx (异步 HTTP 客户端)

注意事项

1. 确保有足够的文件系统权限来创建和读取文件
2. 上传大文件时注意网络超时设置（当前为 30 秒）
3. 上传接口需要网络连接
4. 文件路径支持相对路径和绝对路径

常见问题

Q: 如何修改上传接口地址？ A: 编辑 server.py 文件中的 UPLOAD_API_URL 变量。

Q: 支持哪些文件类型上传？ A: 支持所有文件类型，服务器会自动检测 MIME 类型。

Q: HTML 文件编码是什么？ A: 使用 UTF-8 编码，确保支持中文等多语言字符。