Vibie MCP 是一个 MCP（Model Context Protocol）服务器，旨在让 AI 客户端（如 Claude Desktop、Cursor 等）能够将本地静态文件夹部署到 Vibie 平台，生成永久的 *.vibie.page 网址。
主要能力
- 部署静态文件夹：将包含 index.html、style.css、js/、assets/ 等文件的文件夹上传，创建新的 Vibie 站点。
- 更新已有站点：通过读取文件夹中的 .vibie/site.json 标记文件，重新部署到同一站点，无需手动指定标识。
- 管理站点：列出账户下的所有站点，或获取单个站点的元数据。
- 自动跳过无关文件：上传时自动忽略隐藏文件（如 .git、.vibie、.DS_Store）和 node_modules/ 目录。
- 单文件支持：如果文件夹中只有一个 HTML 文件（任意名称），上传时会自动重命名为 index.html。
使用方式
- 安装配置：推荐使用一行自动设置命令，自动检测 Claude Desktop（Windows Store + APPDATA / macOS / Linux）和 Cursor（~/.cursor/mcp.json）的配置，并添加 vibie 条目。如果自动设置不适用，可手动将配置添加到 MCP 配置文件（如 claude_desktop_config.json、~/.cursor/mcp.json 等）。保存后需完全退出并重启客户端。
- 首次认证：首次调用工具时，服务器会启动 OAuth 2.0 设备授权流程。AI 会收到类似“请打开 https://vibie.io/device?code=XXXX-YYYY 在浏览器中登录 Google 并点击授权，然后让我重试”的指示。授权后，令牌会保存在 ~/.vibie/credentials.json（权限 0600），后续调用自动复用。用户可随时在 https://vibie.io/settings/api 撤销令牌。
- 可用工具：
- vibie_create_site：上传文件夹并创建新站点，自动写入 .vibie/site.json 以便后续更新。
- vibie_update_site：重新部署到已有站点，若未指定则从 .vibie/site.json 读取标识。
- vibie_list_sites：列出账户下的站点。
- vibie_get_site：根据标识获取单个站点的元数据。
适用场景
- 需要将静态 HTML 项目快速部署到公网并获取永久链接的开发者。
- 使用 AI 客户端进行开发，希望直接通过对话完成部署和更新。
- 需要频繁更新静态站点的场景，利用文件夹标记简化重复部署。
限制
- 每个站点最大 100 MB，每次上传最多 500 个文件，单个文件最大 25 MB（由 Vibie 服务器验证）。
- 仅支持静态文件，不涉及服务器端逻辑。
- 需要 Vibie 账户和网络连接进行认证与部署。
