跳轉到主要內容
bricks-ctor 包含一個內建 MCP server，在執行 bun install 期間會自動完成設定。postinstall 指令碼會在您的 .mcp.json 中加入 bricks-ctor 項目： 
{
  "mcpServers": {
    "bricks-ctor": {
      "command": "bun",
      "args": ["./node_modules/@fugood/bricks-ctor/tools/mcp-server.ts"]
    }
  }
}
此 server 提供專案專屬工具，供 AI 編碼代理（Claude Code、Codex、CTOR 等）與其內建工具搭配使用。
請參閱 CTOR MCP 參考文件，深入了解 MCP server 的設定與管理方式。

​
可用工具

執行型別檢查並編譯專案。在專案目錄中執行 bun compile 並回傳建置輸出。
編譯並以無頭模式啟動應用程式預覽，然後截圖。
參數預設值說明
delay3000截圖前的等待毫秒數
width600截圖寬度
height480截圖高度
responseImagefalse以 base64 圖片內容回傳截圖
testId—要觸發的自動化測試 ID
testTitleLike—以部分標題比對尋找自動化測試
此伺服器在 CTOR 內執行時會停用此工具——CTOR 的代理直接驅動內嵌的預覽面板，截圖會與您在面板中看到的內容一致。
以關鍵字搜尋內建的 FontAwesome 6 Pro 圖示集。
參數預設值說明
query—搜尋關鍵字
limit10最大結果數
style—依樣式篩選：brands、duotone、light、regular、solid、thin
回傳符合的圖示名稱、Unicode 代碼及可用樣式。
從 Hugging Face 搜尋並選取 AI 模型，用於 BRICKS 產生器。huggingface_search — 依產生器類型篩選搜尋模型。
參數預設值說明
generatorTypeGeneratorLLM產生器類型（GeneratorLLM、GeneratorVectorStore、GeneratorReranker、GeneratorGGMLTTS、GeneratorGGMLTTSVocoder、GeneratorOnnxLLM、GeneratorOnnxSTT、GeneratorTTS）
query—搜尋關鍵字
limit20最大結果數
includeFilesfalse包含模型檔案清單
huggingface_select — 取得特定模型檔案的下載 URL 與中繼資料。支援 GGUF 和 ONNX 模型、分割檔案、多模態投影檔案，以及語者嵌入。
設定 HF_TOKEN 環境變數以存取 Hugging Face 上的受限模型。
透過 CLI 管理您 BRICKS 工作區中的媒體資產。
  • media_boxes — 列出所有 media box
  • media_get_box — 取得特定 media box 的詳細資訊
  • media_files — 列出 box 中的檔案（可依類型、標籤篩選，支援分頁）
  • media_file — 取得特定檔案的詳細資訊
  • media_upload_files — 上傳檔案至 box，支援選用的圖片縮放、AI 分析和標籤功能