内容
# vibie-mcp
Vibie 的 MCP 服务器 — 将静态文件夹部署到永久的 `*.vibie.page` URL，支持从 Claude Desktop、Cursor 或任何兼容 MCP 的客户端进行部署。
## 安装
### 一键自动设置（推荐）
```sh
npx vibie-mcp setup
```
自动检测 Claude Desktop（Windows Store + APPDATA / macOS / Linux）和 Cursor（`~/.cursor/mcp.json`）配置，然后添加 `vibie` 条目。重启客户端即可完成。
### 手动配置
如果自动设置不适用于您的客户端，请在 MCP 配置文件（`claude_desktop_config.json`、`~/.cursor/mcp.json`等）中添加以下内容：
```json
{
"mcpServers": {
"vibie": {
"command": "npx",
"args": ["-y", "vibie-mcp"]
}
}
}
```
保存后，请完全退出并重启客户端。
## 首次授权
在首次调用工具时，服务器会发起 [OAuth 2.0 设备授权许可](https://datatracker.ietf.org/doc/html/rfc8628)。您的 AI 将收到以下指令：
> 请在浏览器中打开 https://vibie.io/device?code=XXXX-YYYY， 使用 Google 登录并点击 **Authorize**。然后请 AI 再次尝试。
在浏览器中授权后，请 AI 重新尝试相同的请求。服务器会在 `~/.vibie/credentials.json`（chmod 0600）中存储令牌，并在后续调用中重用。
您可以在 https://vibie.io/settings/api 随时撤销令牌。
## 工具
- **`vibie_create_site`** — 上传文件夹并创建新的 Vibie 站点。自动在文件夹中写入 `.vibie/site.json`，以便后续更新使用相同的站点。
- **`vibie_update_site`** — 重新部署到现有站点。如果未指定，则从 `.vibie/site.json` 读取 slug。
- **`vibie_list_sites`** — 列出您账户下的站点。
- **`vibie_get_site`** — 获取一个站点的元数据， 通过 slug。
## AI 通常如何使用它
```
您： "将此文件夹部署到 vibie"
AI： → vibie_create_site({ folder: "." })
→ 返回： https://my-folder-x7f2.vibie.page
您： "推送我的更改"
AI： 检测到 .vibie/site.json
→ vibie_update_site({ folder: "." })
→ 相同的 URL，新内容
```
## 文件夹结构
从文件夹中上传的内容：
- `index.html` + `style.css` + `js/`、`assets/`等 — 全部包含
- 隐藏文件（`.git`、`.vibie`、`.DS_Store`）— 自动跳过
- `node_modules/` — 跳过
- 限制：每个站点 100 MB，每个上传 500 个文件，每个文件 25 MB（Vibie 服务器验证）
单个 HTML 文件（任何名称）也可以正常工作 — 上传时会自动重命名为 `index.html`。
## 环境变量
| 变量 | 默认值 | 目的 |
|---|---|---|
| `VIBIE_API_BASE` | `https://vibie.io` | 用于本地开发的重写（`http://localhost:3000`） |
## 许可证
MIT
