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 許可證。