跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt

Use this file to discover all available pages before exploring further.

Model Context Protocol (MCP) 讓您可以將外部工具伺服器連線到 AI 代理。MCP 工具擴充了代理在內建工具以外的能力。

​
內建 MCP 伺服器

bricks-ctor 包含內建的 bricks-ctor MCP 伺服器，在 bun install 時自動設定。它提供編譯、預覽、搜尋圖示和 Lottie 動畫、選擇 Hugging Face 模型，以及管理媒體資產的工具。

bricks-ctor 內建 MCP 伺服器

請參閱 bricks-ctor 文件中的完整工具參考。

​
設定

MCP 伺服器設定於專案根目錄的 .mcp.json 檔案中： 
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "some-mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

​
傳輸類型

​
stdio

將 MCP 伺服器生成為子程序，透過標準輸入輸出通訊。 
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "some-mcp-server"],
      "env": {}
    }
  }
}
欄位說明
command要執行的指令
args指令參數陣列
env程序的環境變數

​
HTTP

透過 HTTP 連線遠端 MCP 伺服器。 
{
  "mcpServers": {
    "remote-server": {
      "url": "https://mcp.example.com/sse"
    }
  }
}
欄位說明
url伺服器端點 URL

​
管理 MCP 伺服器

點擊側邊欄中的 MCP，開啟 MCP 面板。面板顯示：
  • 已設定伺服器的清單及其連線狀態
  • 綠點 —已連線，顯示可用工具數量
  • 紅點 —已斷線或發生錯誤
  • 每個伺服器的可展開工具清單

​
編輯設定

MCP 面板包含設定編輯器，可直接編輯 .mcp.json。點擊儲存套用變更，點擊重新連線重新建立伺服器連線。

​
工具整合

連線後，MCP 工具與內建工具一起顯示。代理可以像使用其他工具一樣探索並呼叫它們。工具呼叫結果支援文字和圖片內容。 MCP 伺服器連線按專案快取，並在應用程式退出時自動清理。