EdgeOne Pages MCP server for AI agents

EdgeOne Pages MCP is a service for deploying HTML content, folders, or full-stack projects to Tencent EdgeOne Pages, providing you with publicly accessible URLs. It enables quick deployment of websites and applications to Tencent's edge network.

Requirements

Node.js 18 or higher

MCP Server Configuration

Using stdio MCP Server

This full-featured MCP server supports the deploy_folder tool for deploying full-stack projects.

For Tencent Cloud International (Default):

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

For Tencent Cloud China:

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

Legacy MCP Server Configuration

This server supports both deploy_html and deploy_folder_or_zip tools:

{
  "mcpServers": {
    "edgeone-pages-mcp-server": {
      "command": "npx",
      "args": ["edgeone-pages-mcp@latest"],
      "env": {
        // Optional. Provide your EdgeOne Pages API token for folder/zip deployments
        "EDGEONE_PAGES_API_TOKEN": "",
        // Optional. Leave empty to create a new project, or provide name to update existing
        "EDGEONE_PAGES_PROJECT_NAME": ""
      }
    }
  }
}

Using Streaming HTTP MCP Server

For MCP clients supporting HTTP streaming (only supports the deploy_html tool):

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

Available Tools

deploy_html Tool

This tool allows you to quickly deploy HTML content to EdgeOne Pages. It works by:

Receiving your HTML content
Deploying it to EdgeOne Pages Edge Functions
Storing the content in EdgeOne KV Store for fast edge access
Returning a publicly accessible URL that you can immediately share

The tool offers:

Fast deployment of static HTML pages
Automatic URL generation
Edge delivery for optimal performance
Comprehensive error handling

deploy_folder Tool

This tool enables you to deploy entire projects to EdgeOne Pages:

Deploy static website projects
Deploy full-stack applications
Update existing projects or create new ones

Usage Example

Configure your MCP server as shown above

Deploy HTML content:

// Your LLM or application would use the deploy_html tool to send content
// The server will respond with a public URL to your deployed content

Deploy a folder:

// Your application would use the deploy_folder tool to send project files
// The server will deploy the project and return a public URL

For self-hosting with a custom domain, you can use the open-source version available at GitHub.

EdgeOne Pages Documentation

For more information about EdgeOne Pages, refer to:

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "edgeone-pages-mcp-server" '{"command":"npx","args":["edgeone-pages-mcp"],"env":{"EDGEONE_PAGES_API_TOKEN":"","EDGEONE_PAGES_PROJECT_NAME":""}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "edgeone-pages-mcp-server": {
            "command": "npx",
            "args": [
                "edgeone-pages-mcp"
            ],
            "env": {
                "EDGEONE_PAGES_API_TOKEN": "",
                "EDGEONE_PAGES_PROJECT_NAME": ""
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "edgeone-pages-mcp-server": {
            "command": "npx",
            "args": [
                "edgeone-pages-mcp"
            ],
            "env": {
                "EDGEONE_PAGES_API_TOKEN": "",
                "EDGEONE_PAGES_PROJECT_NAME": ""
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect