EdgeOne Pages

你是否曾经在AI编程工具中生成了一个漂亮的网页，却卡在“如何把它部署上线”这一步？或者你需要频繁地部署HTML代码片段进行测试或分享？今天要介绍的开源项目EdgeOne Pages，正是为了解决这个痛点而设计的。它是由腾讯EdgeOne团队打造的MCP服务器，支持将HTML内容、文件夹或全栈项目一键部署到EdgeOne Pages，并立即获得公开访问URL。

项目基本信息

一、项目介绍

EdgeOne Pages MCP服务器是腾讯EdgeOne团队官方推出的MCP工具，让AI能够将生成的代码一键部署到EdgeOne Pages边缘平台，并获得公开访问URL。它支持三种部署方式：

• deploy_html：部署单个HTML字符串
• deploy_folder：部署整个文件夹（静态网站）
• deploy_folder_or_zip：部署文件夹或ZIP包（即将弃用，建议使用deploy_folder）

这个项目的核心价值在于：让AI从“只能生成代码”升级到“生成即部署”。AI生成网页后，通过EdgeOne Pages MCP，可以立即获得一个在线的、可分享的URL，无需手动配置服务器、域名或CDN。

EdgeOne Pages基于腾讯云全球边缘节点，部署的内容会自动分发到边缘网络，实现快速访问。

二、核心优势

一键部署，即时上线

AI生成HTML代码后，通过deploy_html工具即可立即获得公开访问URL，无需任何手动操作。

支持全栈项目

不仅支持静态HTML，还支持完整的文件夹和全栈项目部署。通过deploy_folder工具，可以将整个前端项目部署到EdgeOne Pages。

两种运行模式

支持stdio和HTTP流式两种模式：

• stdio模式：功能完整，支持deploy_folder部署全栈项目
• HTTP模式：适用于支持HTTP流式传输的MCP客户端，支持deploy_html

区域选择

支持国际版和中国版，可根据需要选择部署区域。

边缘分发

基于EdgeOne的边缘网络，部署的内容会自动分发到全球边缘节点，访问速度快。

官方支持

由腾讯EdgeOne团队官方开发和维护，稳定性和兼容性有保障。

三、适用场景

AI生成代码即时预览

当AI为你生成一个网页时，可以立即部署并查看效果，无需手动保存和打开HTML文件。

快速原型分享

将设计原型或演示页面快速部署到线上，通过URL分享给团队成员或客户。

CI/CD集成

在自动化流程中集成EdgeOne Pages MCP，实现代码提交后的自动部署。

前端项目托管

将静态网站或全栈项目部署到EdgeOne Pages，利用边缘网络加速访问。

四、安装教程

系统要求

安装步骤

EdgeOne Pages MCP提供了两种配置方式：全功能stdio模式和HTTP流式模式。

方式一：stdio模式（全功能，推荐）

这种方式功能最完整，支持deploy_html和deploy_folder工具。

对于Cursor或Claude Desktop：

在MCP配置文件中添加：

国际版（默认）：

{
  "mcpServers": {
    "edgeone-pages-mcp-server": {
      "timeout": 600,
      "command": "npx",
      "args": ["edgeone-pages-mcp-fullstack"]
    }
  }
}

中国版：

{
  "mcpServers": {
    "edgeone-pages-mcp-server": {
      "timeout": 600,
      "command": "npx",
      "args": ["edgeone-pages-mcp-fullstack", "--region", "china"]
    }
  }
}

如果需要部署文件夹（需要API令牌）：

{
  "mcpServers": {
    "edgeone-pages-mcp-server": {
      "command": "npx",
      "args": ["edgeone-pages-mcp"],
      "env": {
        "EDGEONE_PAGES_API_TOKEN": "你的API令牌",
        "EDGEONE_PAGES_PROJECT_NAME": "项目名称（可选）"
      }
    }
  }
}

API令牌获取方法：访问 https://edgeone.ai/document/177158578324279296

方式二：HTTP流式模式（仅deploy_html）

这种方式仅支持deploy_html工具，适用于支持HTTP流式传输的MCP客户端。

{
  "mcpServers": {
    "edgeone-pages-mcp-server": {
      "url": "https://mcp-on-edge.edgeone.site/mcp-server"
    }
  }
}

验证安装

配置完成后，重启MCP客户端。尝试让AI“部署一个简单的HTML页面”，如果成功，你会收到一个公开访问URL。

五、使用示例

配置完成后，你就可以在MCP客户端中使用自然语言来部署内容了。

示例1：部署单个HTML字符串

用户指令：“帮我部署一个简单的HTML页面，显示‘Hello World’，并返回URL”

AI会调用deploy_html工具，生成HTML内容，部署到EdgeOne Pages，并返回类似https://xxx.edgeone.app的URL。

示例2：部署整个文件夹

用户指令：“将当前目录下的React项目部署到EdgeOne Pages”

AI会调用deploy_folder工具，上传整个文件夹，完成部署并返回URL。

示例3：更新现有项目

如果你已经在环境变量中配置了EDGEONE_PAGES_PROJECT_NAME，再次部署时会更新同一个项目，而不是创建新项目。

用户指令：“更新刚才部署的项目，使用最新的代码”

示例4：部署全栈应用

EdgeOne Pages支持全栈项目部署。AI可以部署包含后端逻辑的应用（通过EdgeOne Pages Functions）。

示例5：使用HTTP模式快速部署

如果使用HTTP模式配置，你可以直接通过HTTP请求部署HTML：

curl -X POST https://mcp-on-edge.edgeone.site/mcp-server \
  -H "Content-Type: application/json" \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "deploy_html",
      "arguments": {
        "html": "<h1>Hello from API</h1>"
      }
    }
  }'

六、常见问题

问题1：部署HTML后无法访问

解决方案：

• 等待几秒钟，让边缘节点完成分发
• 检查返回的URL是否正确
• 尝试在无痕模式或不同网络下访问

问题2：部署文件夹时提示API令牌无效

解决方案：

• 确认API令牌正确且未过期
• 确认令牌有创建和更新项目的权限
• 检查环境变量EDGEONE_PAGES_API_TOKEN是否正确设置

问题3：中国版和国际版有什么区别？

解决方案：

• 国际版：部署到全球边缘节点，适合面向全球用户
• 中国版：优化在中国大陆的访问速度，符合国内合规要求

问题4：部署的项目多久会过期？

解决方案：EdgeOne Pages部署的内容是持久化的，不会自动过期。你可以通过API或控制台删除。

问题5：是否支持自定义域名？

解决方案：支持。你可以通过EdgeOne Pages控制台绑定自己的域名。MCP服务器本身支持通过自部署版本实现自定义域名绑定：https://github.com/TencentEdgeOne/self-hosted-pages-mcp

七、总结

EdgeOne Pages MCP是MCP生态中第一个由CDN厂商官方推出的部署类服务器。它将EdgeOne Pages的边缘部署能力，通过MCP协议开放给AI编程工具，实现了“生成即部署”的流畅体验。

这个项目的最大价值在于：

1. 即时性：AI生成代码后立即部署上线，无需手动操作
2. 易用性：配置简单，一条npx命令即可使用
3. 边缘加速：基于EdgeOne全球边缘网络，访问速度快
4. 全栈支持：不仅支持静态HTML，还支持全栈项目部署
5. 官方维护：由腾讯EdgeOne团队官方支持，稳定可靠

如果你是AI编程工具的重度用户，经常需要快速验证和分享生成的网页，EdgeOne Pages MCP将极大地提升你的工作效率。 让AI生成的代码，即刻变成可访问的在线应用。