Docs Overview/
Pages MCP/

Pages MCP

什么是 MCP？

MCP（Model Context Protocol，模型上下文协议）是一种开放协议，让 AI 模型能够安全地与本地和远程资源进行交互。

只需在支持 MCP 的客户端（如 Cline、Cursor、Claude 等）进行统一配置。OpenAI 已于 2025 年 3 月宣布支持 MCP 协议，使这一功能在所有主流 AI 平台上得到广泛应用。


EdgeOne Pages Deploy MCP

EdgeOne Pages Deploy MCP 是一项专用服务，能够将 Web 静态资源内容快速部署到 EdgeOne Pages 并生成公开访问链接。这使您能够立即预览和分享 AI 生成的网页内容或项目构建后的产物。

部署 HTML 单文件




部署文件夹或 ZIP 包



配置方法

在任何支持 MCP 的客户端中，您可以使用以下两种方式的 JSON 配置来快速集成 Pages Deploy MCP Server。


基于 Stdio（标准输入输出）

这也是目前大部分 MCP Server 的实现方式，只需在支持 MCP 的应用中添加几行简单配置，就能启动一个功能完善的网页快速部署服务，让 AI 把写完的网页代码发布到边缘节点并提供可访问的 URL。
{
  "mcpServers": {
    "edgeone-pages-mcp-server": {
      "command": "npx",
      "args": ["edgeone-pages-mcp"],
      "env": {
        // 可选，如需部署文件夹或 ZIP 压缩包，则 API Key 必填
        "EDGEONE_PAGES_API_KEY": "",
        // 可选，置空将会创建一个新的 Pages 项目，填入已有的项目名则会更新该项目
        "EDGEONE_PAGES_PROJECT_NAME": ""
      }
    }
  }
}
支持的客户端：Cursor，VSCode，Windsurf，ChatWise，Cheery Studio 等


基于 Streamable HTTP

Stdio 虽然方便，但因为依赖特定的客户端，也存在一定的安全隐患，所以通过 Streamable HTTP 进行远程调用将成为 MCP Server 未来的趋势。

如下所示，仅需指定远程端点即可。
{
  "mcpServers": {
    "edgeone-pages-mcp-server": {
      "url": "https://mcp-on-edge.edgeone.app/mcp-server"
    }
  }
}
支持的客户端：ChatWise
注意：
基于 Streamable HTTP 的方式不支持部署文件夹或 ZIP 包。


技术原理

Pages MCP Server 利用无服务器边缘计算能力和 KV 存储，通过 API 接收 HTML 内容，即可自动生成即时生效的公共访问链接，实现秒级静态页面部署并内置错误处理机制。



构建自己的 MCP 服务

简单来说，MCP 让 AI 在对话过程中可以获取更多的资源，调用更多的工具。下面我们借助两个示例来快速上手部署自己的 MCP Server。


本地 MCP Server

您可以使用 MCP Geo 这个地理位置 MCP 模板进行一键部署，然后在 Cursor 等编辑器添加几行简单的配置即可启用。当 AI 需要获取用户地理位置时，可以通过 get_geo 接口接口自动获取这些信息，然后推荐附近的餐厅或景点。


远程 MCP Server

在第二版本的 MCP Server 协议确定下来后，我们也第一时间将 Pages 的这项专用服务进行升级，支持 Streamable HTTP。访问 https://mcp-on-edge.edgeone.app/ 即可体验网页版 MCP。

您也可以通过 MCP on Edge 模板快速部署基于 EdgeOne 边缘函数实现的 MCP Client 与 MCP Server，其中的环境变量 API_KEY，BASE_URL，MODEL 兼容了 OpenAI 的接口规范，这意味着您可以直接按照 OpenAI 官方的使用方式来配置这几个变量。


以下表格提供了几个获取 API_KEY 的参考
：
平台
BASE_URL
API_KEY（文档地址）
MODEL（示例模型 ID）
https://openrouter.ai/api/v1
https://openrouter.ai/settings/keys
anthropic/claude-3.7-sonnet
https://api.deepinfra.com/v1/openai
https://deepinfra.com/dash/api_keys
anthropic/claude-3-7-sonnet-latest
DeepSeek
https://api.deepseek.com/v1
https://platform.deepseek.com/api_keys
deepseek-chat



为什么使用 EdgeOne Pages？

MCP 技术趋势与 Pages Functions 的边缘无服务器架构高度契合，其在性能、可扩展性和易用性上的优势，使开发者无需管理基础设施即可享受全球边缘网络的便利。我们将持续跟进业界动态，结合社区技术演进方向，不断增强 MCP 相关能力，助力开发者提升效能与开发体验。

关于 Pages 的更多详情，可查看文档其他章节。