mcpField
V
vibie-mcp

vibie-mcp

本地服务
github.com/shdomi8599云与基础设施122 周前更新
代码仓库

关于 vibie-mcp

vibie-mcp 让 Claude Desktop、Cursor 等 MCP 客户端将静态文件夹发布到 Vibie 网址，并更新已有站点。它通过 OAuth 授权，并用文件夹标记支持后续部署。

主要功能

  1. 01从文件夹创建站点
  2. 02更新已有站点
  3. 03列出账户站点
  4. 04获取站点元数据
  5. 05跳过隐藏文件和 node_modules

适用场景

  1. 01发布静态 HTML 文件夹
  2. 02将更改重新部署到原网址

MCP 相关

这是一个 MCP 服务，向兼容客户端提供创建、更新、列出 Vibie 站点及获取站点元数据的工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "shdomi8599-vibie": {
      "command": "npx",
      "args": [
        "-y",
        "vibie-mcp"
      ]
    }
  }
}
启动命令npx -y vibie-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmvibie-mcp0.2.2

工具

4

收录的工具列表 · 更新于 2 周前

参数类型必填说明
namestring否显示名称。默认使用文件夹名称。
notestring否可选的部署说明（变更日志风格）。
folderstring是包含 index.html（或单个 HTML 文件）的文件夹的绝对路径或相对路径。必填。
categorystring否类别 ID（portfolio / wedding / landing / event / game / photo / linkbio / misc）。默认为 misc。
is_publicboolean否站点是否显示在公共图库中。默认为 true。

详细介绍

vibie-mcp

适用于 Vibie 的 MCP 服务 — 从 Claude Desktop / Cursor / 任意兼容 MCP 的客户端，将静态文件夹部署到永久的 *.vibie.page URL。

安装

一行命令自动配置（推荐）
npx vibie-mcp setup

自动检测 Claude Desktop（Windows Store + APPDATA / macOS / Linux）和 Cursor（~/.cursor/mcp.json）的配置，然后添加 vibie 条目。重启客户端即可完成。

手动配置

如果自动配置不适用于你的客户端，请将以下内容添加到 MCP 配置（claude_desktop_config.json、~/.cursor/mcp.json 等）中：

{
  "mcpServers": {
    "vibie": {
      "command": "npx",
      "args": ["-y", "vibie-mcp"]
    }
  }
}

保存后，请完全退出并重启客户端。

首次授权

首次调用工具时，服务会发起 OAuth 2.0 设备授权许可。你的 AI 会收到类似以下说明：

请在浏览器中打开 https://vibie.io/device?code=XXXX-YYYY，使用 Google 登录，然后点击 Authorize。之后请让我重试。

在浏览器中完成授权后，请让 AI 重试同一请求。服务会将令牌保存在 ~/.vibie/credentials.json（chmod 0600）中，并在后续调用时重复使用。

你可以随时在 https://vibie.io/settings/api 撤销令牌。

工具

  • vibie_create_site — 上传文件夹并创建新的 Vibie 网站。会自动在文件夹中写入 .vibie/site.json，以便后续更新使用同一网站。
  • vibie_update_site — 重新部署到现有网站。如果未指定 slug，则从 .vibie/site.json 读取。
  • vibie_list_sites — 列出你账号下的网站。
  • vibie_get_site — 按 slug 获取单个网站的元数据。

AI 通常如何使用

You: "Deploy this folder to vibie"
AI: → vibie_create_site({ folder: "." })
    → Returns: https://my-folder-x7f2.vibie.page

You: "Push my changes"
AI: Detects .vibie/site.json
    → vibie_update_site({ folder: "." })
    → Same URL, new content

文件夹结构

从文件夹上传的内容：

  • index.html + style.css + js/、assets/ 等 — 均会包含在内
  • 隐藏文件（.git、.vibie、.DS_Store）— 自动跳过
  • node_modules/ — 跳过
  • 限制：每个网站最大 100 MB，每次上传最多 500 个文件，每个文件最大 25 MB（由 Vibie 的服务验证）

单个 HTML 文件（任意名称）也可使用 — 上传时会自动重命名为 index.html。

环境变量

变量默认值用途
VIBIE_API_BASEhttps://vibie.io本地开发时的覆盖值（http://localhost:3000）

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。