EdgeOne Pages MCP Server

EdgeOne Pages MCP

An MCP service for deploying HTML content, folders, or full-stack projects to EdgeOne Pages and obtaining publicly accessible URLs.

Demo

Deploy HTML

Deploy Folder

Requirements

• Node.js 18 or higher

Deployment on Tencent Cloud

This MCP service supports multiple deployment options. Choose the one that best fits your needs.

Option 1: Deploy Self-Hosted Version to EdgeOne Pages (Recommended)

This is the simplest and fastest deployment method, suitable for scenarios requiring HTTP access.

Step 1: One-Click Deploy to EdgeOne Pages

1. Visit the self-hosted repository
2. Click the "One-Click Deploy" button to deploy the service to EdgeOne Pages
3. Complete the deployment configuration as prompted

Step 2: Configure KV Storage

After deployment, configure KV storage for storing website files:

1. Go to EdgeOne Pages console
2. Find KV Storage configuration
3. Follow the KV Storage Setup Guide

Step 3: Bind Custom Domain (Optional)

1. Add a custom domain in project settings
2. Configure DNS CNAME record
3. Wait for domain verification
4. Refer to Custom Domain Binding Guide

Step 4: Configure MCP Client

After deployment, add to your MCP configuration file:

{
  "mcpServers": {
    "edgeone-pages": {
      "url": "https://your-custom-domain.com/mcp-server"
    }
  }
}

Advantages:

• ✅ Zero server maintenance cost
• ✅ Auto-scaling and high availability
• ✅ Global edge acceleration
• ✅ Custom domain and HTTPS support

Option 2: Deploy on Tencent Cloud CVM

Suitable for scenarios requiring full server control or stdio transport.

Step 1: Prepare CVM Instance

1. Log in to Tencent Cloud Console
2. Create or select a CVM instance
3. Recommended configuration:
   • OS: Ubuntu 20.04 LTS or CentOS 7+
   • CPU: 2 cores or more
   • Memory: 4GB or more
   • Network: Configure public IP or elastic IP

Step 2: Install Node.js Environment

Ubuntu/Debian:

# Update system packages
sudo apt update

# Install Node.js 18.x
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# Verify installation
node --version
npm --version

CentOS/RHEL:

# Install Node.js 18.x
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo yum install -y nodejs

# Verify installation
node --version
npm --version

Step 3: Deploy MCP Service

# Clone project (or upload project files)
git clone https://github.com/TencentEdgeOne/edgeone-pages-mcp.git
cd edgeone-pages-mcp

# Install dependencies
npm install

# Build project
npm run build

# Configure environment variables
cat > .env << EOF
EDGEONE_PAGES_API_TOKEN=your-api-token-here
EDGEONE_PAGES_PROJECT_NAME=your-project-name
EOF

Step 4: Configure Process Management (Using PM2)

# Install PM2
sudo npm install -g pm2

# Start service
pm2 start dist/index.js --name edgeone-pages-mcp

# Set auto-start on boot
pm2 startup
pm2 save

# Check service status
pm2 status
pm2 logs edgeone-pages-mcp

Step 5: Configure Firewall

# Ubuntu/Debian (UFW)
sudo ufw allow 22/tcp    # SSH
# If using HTTP transport, open corresponding port
# sudo ufw allow 8080/tcp

# CentOS (firewalld)
sudo firewall-cmd --permanent --add-service=ssh
# sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

Step 6: Configure MCP Client

If using stdio transport (local or SSH):

{
  "mcpServers": {
    "edgeone-pages-mcp-server": {
      "command": "node",
      "args": ["/path/to/edgeone-pages-mcp/dist/index.js"],
      "env": {
        "EDGEONE_PAGES_API_TOKEN": "your-api-token",
        "EDGEONE_PAGES_PROJECT_NAME": "your-project-name"
      }
    }
  }
}

Advantages:

• ✅ Full control over server environment
• ✅ Support for stdio transport
• ✅ Suitable for enterprise intranet environments

Option 3: Deploy Using Tencent CloudBase

Suitable for scenarios requiring quick deployment with Tencent Cloud managed services.

Step 1: Create CloudBase Environment

1. Visit Tencent CloudBase Console
2. Create a new environment or select an existing one
3. Choose Node.js 18+ runtime

Step 2: Deploy Code

1. Select "Cloud Functions" in CloudBase console
2. Create a new function or upload code
3. Configure function entry as index.js