Buildez MCP

🚀 Buildez MCP 服务器

通过任何与 MCP 兼容的工具，利用人工智能构建完整的网站。本项目借助 MCP 服务器，将 AI 助手与 Buildez.ai 相连，让你只需描述需求，就能创建出完整的网站。

✨ 主要特性

• 借助 AI 能力，根据用户描述快速生成完整网站。
• 支持多种与 MCP 兼容的工具，方便不同用户使用。

📦 安装指南

步骤 1：安装 Node.js（必需）

Windows

1. 访问 nodejs.org/en/download。
2. 点击“Windows Installer (.msi)”按钮。
3. 运行下载的文件。
4. 依次点击“下一步”→“下一步”→“下一步”→“安装”。
5. 重启计算机（或者至少关闭并重新打开命令提示符）。

Mac

brew install node

或者从 nodejs.org 下载。

Linux

sudo apt install nodejs npm

步骤 2：安装 Buildez MCP

打开 命令提示符（Windows）或 终端（Mac/Linux）并运行：

npm install -g buildez-mcp

Windows 提示：按下 Win + R，输入 cmd，按下回车键打开命令提示符。

步骤 3：验证安装

buildez-mcp --help

如果看到输出（而非错误信息），则表示安装成功。

💻 使用示例

支持的工具及配置

VS Code (GitHub Copilot)

VS Code 现在通过 GitHub Copilot 支持 MCP 服务器。

• 选项 1：用户设置（所有项目）
  1. 打开 VS Code。
  2. 按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）。
  3. 输入“Preferences: Open User Settings (JSON)”并按下回车键。
  4. 在设置中添加以下内容：

{
  "mcp": {
    "servers": {
      "buildez": {
        "command": "npx",
        "args": ["buildez-mcp"],
        "env": {
          "BUILDEZ_API_URL": "https://buildez.ai"
        }
      }
    }
  }
}

• 选项 2：工作区设置（单个项目） 在项目中创建一个 .vscode/mcp.json 文件：

{
  "servers": {
    "buildez": {
      "command": "npx",
      "args": ["buildez-mcp"],
      "env": {
        "BUILDEZ_API_URL": "https://buildez.ai"
      }
    }
  }
}

5. 重启 VS Code。
6. 打开 Copilot Chat 并提问：“为我的咖啡店构建一个网站”。

注意：需要 GitHub Copilot 订阅和 VS Code 1.99+ 版本。

Cursor IDE

• Windows 编辑文件：C:\Users\YOUR_USERNAME\.cursor\mcp.json

{
  "mcpServers": {
    "buildez": {
      "command": "npx",
      "args": ["buildez-mcp"],
      "env": {
        "BUILDEZ_API_URL": "https://buildez.ai"
      }
    }
  }
}

• Mac / Linux 编辑文件：~/.cursor/mcp.json

{
  "mcpServers": {
    "buildez": {
      "command": "npx",
      "args": ["buildez-mcp"],
      "env": {
        "BUILDEZ_API_URL": "https://buildez.ai"
      }
    }
  }
}

然后重启 Cursor。

Claude Desktop

• Windows 编辑文件：C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "buildez": {
      "command": "npx",
      "args": ["buildez-mcp"],
      "env": {
        "BUILDEZ_API_URL": "https://buildez.ai"
      }
    }
  }
}

• Mac 编辑文件：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "buildez": {
      "command": "npx",
      "args": ["buildez-mcp"],
      "env": {
        "BUILDEZ_API_URL": "https://buildez.ai"
      }
    }
  }
}

然后重启 Claude Desktop。

Claude Code (CLI)

Claude Code 内置了 MCP 支持。只需运行以下命令：

claude mcp add buildez-mcp -- npx buildez-mcp

验证是否添加成功：

claude mcp list

使用方法：启动 Claude Code 并提问：

"为我的咖啡店 Bean Dreams 构建一个网站"

Cline (VS Code 扩展)

1. 在 VS Code 中安装 Cline 扩展。
2. 打开 Cline 设置。
3. 转到 MCP 服务器部分。
4. 添加以下内容：

{
  "buildez": {
    "command": "npx",
    "args": ["buildez-mcp"],
    "env": {
      "BUILDEZ_API_URL": "https://buildez.ai"
    }
  }
}

Windsurf

编辑你的 Windsurf MCP 配置并添加：

{
  "mcpServers": {
    "buildez": {
      "command": "npx",
      "args": ["buildez-mcp"],
      "env": {
        "BUILDEZ_API_URL": "https://buildez.ai"
      }
    }
  }
}

实际使用示例

设置完成后，只需向 AI 提出构建网站的需求即可，例如：

• "为西雅图一家名为 Morning Brew 的咖啡店构建一个网站"
• "为摄影师 Sarah 创建一个作品集网站"
• "为一家珠宝店构建一个电子商务网站"
• "为一家专门从事家庭法的律师事务所制作一个网站"

AI 将完成以下操作：

1. 分析你的需求。
2. 选择最佳组件（有 170 多种可用组件）。
3. 为你的业务生成自定义内容。
4. 部署网站。
5. 提供实时 URL。

可用工具

示例输出

✅ 网站 "Tony's Pizzeria" 创建成功！

实时 URL: https://webid.is/tonys-pizzeria-x7k2m9
编辑器: https://buildez.ai/editor/tonys-pizzeria-x7k2m9

使用的组件:
- 带有餐厅品牌的英雄区域
- 菜单展示
- 联系信息
- 在线订购
- 客户评价
- 带有位置地图的页脚

📚 详细文档

故障排除

Windows: "npm is not recognized"

• Node.js 未安装或未添加到系统路径中。
• 从 nodejs.org/en/download 重新安装 Node.js。
• 安装后确保 重启命令提示符。

Windows: "buildez-mcp is not recognized"

• 再次运行 npm install -g buildez-mcp。
• 尝试使用完整路径：%APPDATA%\npm\buildez-mcp。

MCP 显示 "Error" 或红色圆点

• 重启你的 IDE/应用程序。
• 检查 BUILDEZ_API_URL 是否设置为 https://buildez.ai。

网站无法生成

• 检查网络连接。
• 先尝试使用更简单的描述。

相关链接

• 网站：buildez.ai
• 文档：buildez.ai/docs
• 支持：support@buildez.ai

📄 许可证

本项目采用 MIT 许可证。