内容
# VibeDrop
智能代理原生静态网站托管服务。告诉你的智能代理部署一个文件夹 — 立即获取一个公开的网址。
- 官网：<a href="https://vibedrop.cc">https://vibedrop.cc</a>
- 技能：[`skill.md`](https://vibedrop.cc/skill.md)
- 命令行工具：[`@vibedrop/cli`](./packages/cli)
- MCP 服务器：[`@vibedrop/mcp`](./packages/mcp)
- 软件开发工具包：[`@vibedrop/sdk`](./packages/sdk)
本仓库包含开源的客户端。托管服务本身运行在 [vibedrop.cc](https://vibedrop.cc)。
## 快速开始 — 将以下提示粘贴到你的智能代理中
将以下内容粘贴到 Claude Code、Cursor、Windsurf 或任何可以读取网址的智能代理中：
> 读取 https://vibedrop.cc/skill.md 并按照说明设置 VibeDrop。
三个步骤，大约 30 秒：
1. **粘贴提示。** 任何可以获取网址的智能代理都可以使用。
2. **智能代理安装自身。** 它读取 `skill.md`，运行 `npm i -g @vibedrop/cli`，并配置一个匿名的 API 密钥。无需注册，无需信用卡。
3. **请求一个网址。** 指向任何包含 `index.html` 的文件夹 — `dist/`、`out/`、`build/` 来自 Vite、`next export`、Astro、SvelteKit、CRA 等。
然后说类似的话：
- “将 `./site` 上线并将链接发送给我。”
- “构建此内容并将输出部署到 VibeDrop。”
- “部署您刚刚编写的登录页面。”
### 什么是可部署的文件夹？
任何在其根目录下包含 `index.html` 的内容：
- **框架构建输出** — 来自 Vite、`next export`、Astro、SvelteKit、CRA 等的 `dist/`、`out/`、`build/`
- **纯 HTML** — 手写的 `index.html` 及其资产、单文件模型、AI 生成的登录页面。
- **智能代理刚刚编写的文件** — “部署您刚刚创建的文件夹。”
- **Chrome 扩展或 Electron 本地页面** — 任何静态 HTML 目录。
VibeDrop 仅提供静态文件服务。如果您的框架需要构建步骤，请先运行它，然后指向输出目录。
## 替代方案
### MCP 服务器
如果您希望智能代理调用 `deploy` 作为原生工具（而不是使用命令行工具），请安装 MCP 服务器：
```bash
claude mcp add vibedrop -- npx @vibedrop/mcp
```
Cursor / Windsurf — 添加到您的 MCP 配置：
```json
{
"mcpServers": {
"vibedrop": { "command": "npx", "args": ["-y", "@vibedrop/mcp"] }
}
}
```
### 命令行工具（人类）
```bash
npx @vibedrop/cli deploy ./dist
```
### 软件开发工具包（Node）
```ts
import { VibedropClient, packDir } from "@vibedrop/sdk";
const client = new VibedropClient({ apiKey: process.env.VIBEDROP_KEY });
const zip = await packDir("./dist");
const { site } = await client.deploy(zip);
console.log(site.url);
```
## 开发
```bash
pnpm install
pnpm build
pnpm typecheck
```
## 许可证
MIT — 请参阅 [LICENSE](./LICENSE)。
