内容
# warpweb-mcp
[Warpweb API](https://warpweb.ai) 官方 MCP 服务器 — 通过任何与 MCP 兼容的客户端（Claude Desktop、Claude Code、Cline、Cursor 等）研究、构建和部署 AI 生成的网站。
```
你： "为德克萨斯州奥斯汀的 Brookside Plumbing 构建一个网站，联系方式为 owner@brooksideplumbing.com。"
克劳德：我将使用 warpweb create_site 工具。
[工具调用 → siteId 返回，构建开始]
网站已排队。实际构建需要 3-8 分钟。我将轮询状态...
[工具调用 → get_site]
... 完成。在 https://brookside-plumbing-a1b2c3.warpweb.app 上线
```
一次 POST 请求 → 研究 → 构建 → 部署。Warpweb 拉取 Google Places 数据（营业时间、照片、评论、服务区域），编写垂直匹配的文案，生成设计，构建多页面网站，添加 SEO（元标签、站点地图、Schema.org JSON-LD），并部署到免费的 `*.warpweb.app` 子域名。适用于服务型本地企业（贸易、诊所、沙龙、机构、餐厅、房地产）。
---
## 快速入门
### 1. 获取 API 密钥
在 [warpweb.ai](https://warpweb.ai) 注册，然后在 [warpweb.ai/app](https://warpweb.ai/app) 处获取密钥。密钥格式为 `wwk_...`。注册后，您将获得 520 个免费积分 — 足以进行一次完整的构建和几次修订，无需绑定信用卡。
### 2. 添加到您的 MCP 客户端
**Claude Desktop** — 编辑 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"warpweb": {
"command": "npx",
"args": ["-y", "warpweb-mcp"],
"env": {
"WARPWEB_API_KEY": "wwk_您的密钥_在此"
}
}
}
}
```
**Claude Code** — 通过 MCP UI 或 `claude mcp add` 添加：
```bash
claude mcp add warpweb npx -y warpweb-mcp --env WARPWEB_API_KEY=wwk_您的密钥_在此
```
**Cline / Cursor / 其他** — 格式相同：命令 `npx`，参数 `["-y", "warpweb-mcp"]`，环境变量 `WARPWEB_API_KEY`。任何支持 MCP stdio 的客户端都可以使用。
### 3. 重启客户端并尝试提示
```
"为德克萨斯州奥斯汀的 Acme Plumbing 构建一个网站，联系方式为 owner@acmeplumbing.com。
强调 24/7 紧急服务。"
```
客户端从工具列表中选择 `create_site`，触发构建，并轮询直到部署 URL 上线。
---
## 暴露的工具
十个工具，与 Warpweb V1 REST API 一一对应。完整的请求/响应格式参见 [docs.warpweb.ai](https://docs.warpweb.ai)。
### 企业
- **`search_businesses`** — 在构建前根据 Google Places 消除企业名称歧义。用户只提供名称时调用此工具（例如“Acme Plumbing”）；直接调用 `create_site` 将静默选择错误的匹配。返回最多 5 个候选项，包含 `placeId`、地址、电话、评分 — 将选定的 `placeId` 传递给 `create_site` 以实现精确匹配。免费。
### 网站
- **`create_site`** — 启动端到端构建。立即返回 `siteId`；实际构建需要 3–8 分钟。轮询 `get_site` 或订阅 `site.complete` 生命周期 webhook。
- **`get_site`** — 获取单个网站的当前状态。用于轮询构建（每 2–5 秒），当 `status` 为 `generating` 时。
- **`list_sites`** — 列出账户下的所有网站。
- **`refresh_site`** — 刷新免费子域名网站的不活动计时器（7 天后自动暂停）。幂等且免费。
### 修订版
- **`create_revision`** — 已部署网站的对话式编辑。发送纯英文提示；Warpweb 自动路由小型手术编辑或大型结构更改。异步，返回 `revisionId`。
### 域名
- **`check_domain`** — 检查候选域名的可用性和价格。免费，返回几个相关建议。
- **`register_domain`** — 通过 Cloudflare Registrar 购买域名并将其附加到网站。必须先调用 `check_domain`；`price` 字段必须与那里返回的美分匹配。
- **`attach_domain`** — 适用于已在其他地方注册的客户域名。返回要在其现有注册商处设置的 CNAME 目标。
### Webhooks
- **`configure_form_webhook`** — 将网站上的表单提交指向您的 HTTP(S) 端点。每次交付都使用 HMAC-SHA256 签名；签名密钥在首次配置或轮换时返回 **一次** — 立即捕获它。
LLM 通过 MCP 在运行时获取完整的输入模式（必填/选填字段、类型、描述）— 无需记住参数。
---
## 示例提示
- *"为[企业名称]在[城市, 省]构建一个网站，联系邮箱[邮箱]。"*
- *"检查<域名>是否可用以及需要多少费用。"*
- *"在网站<网站ID>上，将标题更改为提及免费估价并添加有关紧急服务的FAQ。"*
- *"将域名`acmeplumbing.com`附加到网站<网站ID> — 客户已经在GoDaddy拥有它。"*
- *"配置网站<网站ID>上的表单提交，以POST到`https://my-crm.example.com/leads`。"*
---
## 定价
- **注册后 520 积分免费**（需邮箱验证）。
- **积分包**，一次性 Stripe Checkout：
- 基础 — 5 美元兑换 100 积分
- 构建者 — 25 美元兑换 600 积分（16% 批量折扣）
- 专业 — 100 美元兑换 2800 积分（29% 批量折扣）
- **活动网站订阅** — 10 美元/网站/月，仅限附加自定义域名的网站。免费子域名网站无每月费用。
每次调用的定向积分成本：
| 工具 | 费用 |
|---|---|
| `create_site` | ~200–500 积分（按实际 AI 使用量计费，构建结束时结算） |
| `create_revision` | ~20–100 积分 |
| `attach_domain` | 5 积分 |
| `register_domain` | 50 积分 + 注册商透过费用 |
| `search_businesses`, `check_domain`, `get_site`, `list_sites`, `refresh_site`, `configure_form_webhook` | 免费 |
---
## 故障排除
**`检查 WARPWEB_API_KEY 环境变量`（401）**
客户端配置中的密钥丢失、格式错误或已被吊销。在 [warpweb.ai/app](https://warpweb.ai/app) 处获取新的密钥。密钥以 `wwk_` 开头。
**`在 warpweb.ai/app/credits 处添加积分`（402）**
账户余额为 0 且未开启自动充值。添加积分或在仪表盘上开启自动充值。
**`每日配额已超`（429）**
存在每日站点/修订/域名限制，以防止失控循环。错误消息包含具有 `used`、`limit` 和 `resetDescription` 的配额对象。
**`queue_full: true`（修订的 429）**
每个站点有 3 个修订队列深度（1 个运行中 + 2 个等待中）。在队列更多修订之前，请等待当前修订落地。
**客户端连接时工具列表为空**
`WARPWEB_API_KEY` 未在客户端配置的 `env` 块中设置。服务器以 NO-TOOL 模式启动，因此连接仍然完成 — 设置环境变量并重启客户端。
**是否要测试针对预发布环境？**
将 `WARPWEB_API_URL` 设置为指向不同的基准 URL（默认为 `https://api.warpweb.ai/v1`）。
---
## 不使用 Warpweb 的情况
- 您的企业没有 Google Places 列表。Warpweb 适用，但结果更通用 — 研究会回落到您的 `businessDescription`。适用于服务型本地企业（贸易、诊所、沙龙、机构、餐厅、房地产）。
- 您需要手工编码的模板和像素级控制。Warpweb 生成布局；它不接受 Figma 规范作为输入。请使用 Next.js / Astro。
- 您需要拖放式构建器 UI。Warpweb 仅支持 API。
- 静态个人网站，且从不更改。单独使用 Cloudflare Pages 更便宜。
---
## 链接
- API 参考文档：[docs.warpweb.ai](https://docs.warpweb.ai)
- 市场营销和注册：[warpweb.ai](https://warpweb.ai)
- API 密钥管理：[warpweb.ai/app](https://warpweb.ai/app)
- 仓库：[github.com/northbeamsoftware/warpweb-mcp](https://github.com/northbeamsoftware/warpweb-mcp)
- 机器可读参考（适用于 LLM 代理）：[warpweb.ai/llms-full.txt](https://warpweb.ai/llms-full.txt)
## 许可证
MIT — 参见 [LICENSE](./LICENSE)。
## 贡献
欢迎在 [github.com/northbeamsoftware/warpweb-mcp](https://github.com/northbeamsoftware/warpweb-mcp) 提交问题和 PR。新工具应与公共 V1 端点一一对应；不要公开内部 Warpweb 概念。
