How do I use Demox MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Demox MCP Server deploy the dist directory" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@demox-site/mcp-server

npm version License: MIT

Demox MCP Server - 通过 AI 部署静态网站到 Demox 平台

📖 目录

什么是 MCP？

MCP (Model Context Protocol) 是 AI 助手与工具之间的标准化协议，允许 AI 工具（如 Claude Code、Cursor）安全地调用外部服务。

功能特性

🚀 一键部署: 部署静态网站到 Demox 平台
📦 自动打包: 支持直接传入目录，自动打包成 ZIP
☁️ 云存储上传: 使用 CloudBase Storage，支持大文件（最大 500MB）
🔐 自动登录: Token 过期时自动触发登录流程
💻 AI 集成: 与 Claude Code、Cursor 等 MCP 客户端无缝集成
📋 网站管理: 查看、删除、管理已部署的网站

快速开始

安装 MCP Server

在 AI 工具配置中使用 npx（推荐）

无需安装，直接在配置文件中使用：

{ "mcpServers": { "demox": { "command": "npx", "args": ["-y", "@demox-site/mcp-server"] } } }

配置后重启 AI 工具，首次使用时会自动打开浏览器登录。

配置步骤

1. 配置 AI 工具

根据您使用的 AI 工具，将以下配置导入到相应位置：

Claude Desktop / Claude Code

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%/Claude/claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

配置示例：

{ "mcpServers": { "demox": { "command": "npx", "args": ["-y", "@demox-site/mcp-server"] } } }

Cursor AI

macOS / Linux: ~/.cursor/mcp.json Windows: %APPDATA%/Cursor/mcp.json

Cline (VS Code 插件)

所有平台: ~/.cline/mcp.json

Continue (VS Code 插件)

所有平台: ~/.continue/mcp.json

2. 重启 AI 工具

配置完成后，重启您的 AI 工具。

3. 首次使用

首次调用 MCP 工具时，会自动打开浏览器登录。

登录成功后，凭证会保存在本地（~/.demox/token.json），Access Token 有效期 5 分钟，Refresh Token 有效期 30 天。

自动登录：Token 过期时会自动打开浏览器，无需手动运行登录命令。

可用工具

deploy_website

部署静态网站到 Demox 平台。

参数:

zipFile (string, 必需): ZIP 文件路径或目录路径
- 支持本地 ZIP 文件：./dist.zip
- 支持本地目录（自动打包）：./dist
- 支持 HTTPS URL（必须 .zip 结尾）：https://example.com/file.zip
fileName (string, 可选): 网站名称，用于标识和展示
websiteId (string, 可选): 网站 ID，更新现有网站时提供

限制:

仅支持 ZIP 文件格式
最大文件大小：500MB
不支持 base64 编码内容

list_websites

获取用户在 Demox 平台上的所有网站列表。

返回信息:

网站 ID
网站名称
访问 URL
创建时间

get_website

获取指定网站的详细信息。

参数:

websiteId (string, 必需): 要查询的网站 ID

delete_website

删除指定的网站及其所有文件。

参数:

websiteId (string, 必需): 要删除的网站 ID

⚠️ 注意: 此操作不可撤销

使用示例

在 Claude Desktop 中

用户: 部署 dist 目录到 Demox Claude: 好的，我来帮您部署 dist 目录。 [检测到目录，自动打包成 ZIP...] [正在上传文件到 CloudBase Storage...] [文件上传成功] ✅ 网站部署成功！网站名称: dist 网站 ID: ABC12345 访问地址: https://abc12345.demox.site

在 Cursor 中

# 在 Cursor 的 Chat 中输入部署当前项目到 Demox # Cursor 会自动： # 1. 检测到项目目录（如 ./dist） # 2. 自动打包成 ZIP # 3. 上传到云存储 # 4. 调用云函数部署 # 5. 返回访问链接

示例对话

场景 1：部署新网站

用户: 把我的 react 项目的 build 目录部署到 Demox Claude: 我来帮您部署 React 项目的 build 目录。 [正在打包目录 ./build...] [文件大小: 2.3MB] ✅ 网站部署成功！网站名称: build 网站 ID: XYZ67890 访问地址: https://xyz67890.demox.site 您现在可以访问上述地址查看您的网站了。

场景 2：更新现有网站

用户: 更新网站 ABC12345 Claude: 我来帮您更新网站 ABC12345。 [文件大小: 2.5MB] ✅ 网站部署成功！网站名称: my-project 网站 ID: ABC12345 访问地址: https://abc12345.demox.site

场景 3：查看所有网站

用户: 显示我部署的所有网站 Claude: 我来帮您查看所有已部署的网站。 📋 您的网站列表（共 3 个） 1. **my-portfolio** - ID: `ABC12345` - URL: https://abc12345.demox.site - 创建时间: 2026-01-20 14:30:00 2. **blog** - ID: `XYZ67890` - URL: https://xyz67890.demox.site - 创建时间: 2026-01-21 09:15:00 3. **docs** - ID: `DEF24680` - URL: https://def24680.demox.site - 创建时间: 2026-01-22 16:45:00

常见问题

Token 过期怎么办？

自动登录：系统会在 Token 过期时自动打开浏览器登录，无需手动操作。

登录成功后会自动重试失败的工具调用。

支持哪些文件格式？

仅支持 ZIP 文件或目录：

✅ 本地 ZIP 文件：./dist.zip
✅ 本地目录：./dist（自动打包成 ZIP）
✅ HTTPS URL：https://example.com/file.zip（必须 .zip 结尾）
❌ 其他压缩格式（tar.gz, rar 等）
❌ Base64 编码内容

最大文件大小限制？

500MB

大文件会被流式传输，不会占用大量内存。

如何撤销授权？

删除本地 Token 文件：

rm ~/.demox/token.json

下次使用时会自动触发登录。

支持哪些 AI 工具？

所有支持 MCP 协议的 AI 工具：

Claude Desktop / Claude Code
Cursor AI
Cline (VS Code 插件)
Continue (VS Code 插件)
其他 MCP 客户端

多台设备可以使用吗？

可以。每台设备需要单独登录，互不影响。

如何查看调试日志？

MCP Server 的日志会输出到 stderr，可以在 AI 工具的日志中查看。

技术细节

文件上传流程

输入（文件/目录/URL） ↓ 转换为本地 ZIP 文件 ↓ 检查文件大小（最大 500MB） ↓ 上传到 CloudBase Storage（流式传输） ↓ 获取 fileId ↓ 云函数从 Storage 下载并部署

安全性

OAuth 2.0 认证: 使用标准的 OAuth 2.0 协议
Token 加密存储: 本地存储的 Token 包含 Refresh Token
自动刷新: Access Token 过期后自动刷新
作用域限制: Token 仅包含必要的权限范围

技术支持

📖 文档: https://demox.site
🐛 Issues: https://github.com/demox-site/mcp-server/issues
📧 邮箱: support@demox.site

开发

本地开发

# 克隆项目 git clone https://github.com/demox-site/mcp-server.git cd mcp-server # 安装依赖 npm install # 开发模式 npm run dev # 构建 npm run build # 测试 MCP Server node dist/index.js

贡献

欢迎贡献代码！请遵循以下步骤：

Fork 本仓库
创建特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
开启 Pull Request

许可证

MIT License

Made with ❤️ by Demox Team