Trae 模型上下文協(xié)議(MCP)- 連接外部工具與服務

2025-04-23 15:07 更新

通過模型上下文協(xié)議(Model Context Protocol,MCP),你可以將外部工具和服務連接至 Trae IDE 進行使用。

什么是 MCP?

Model Context Protocol (MCP) 是一種協(xié)議,它允許大型語言模型(LLMs)訪問自定義的工具和服務。Trae 中的智能體作為 MCP 客戶端可以選擇向 MCP Server 發(fā)起請求,以使用它們提供的工具。你可以自行添加 MCP Server,并添加到自定義的智能體中來使用。更多信息參閱 MCP 官方文檔

在 Trae IDE 中,MCP Server 支持兩種傳輸類型:stdio 傳輸、SSE 傳輸。

免責聲明

MCP Server 由第三方構(gòu)建和維護。Trae 不審查或認可這些服務器,并且不對其行為、任何 MCP Server 調(diào)用失敗或它們返回的數(shù)據(jù)承擔任何責任。部分 MCP Server 也可能因相關(guān)法律法規(guī)、網(wǎng)絡限制、或服務器自身的訪問策略,在你所在的國家或地區(qū)無法訪問或使用。Trae 無法控制這些因素,亦無法保證你所在國家或地區(qū)對這些服務器的可用性或功能性。你在嘗試使用這些服務器時,應自行確保遵守當?shù)胤煞ㄒ?guī)。

配置系統(tǒng)環(huán)境

為確保正常使用 MCP,你需要安裝以下依賴:

  • npx:依賴于 Node.js,版本需大于等于 18。
  • uvx:基于 Python 的快速執(zhí)行工具,需手動安裝。

下載并安裝 Node.js

  1. 請前往 Node.js 官網(wǎng),下載并安裝 Node.js 18 或更高版本。
  2. 安裝完成后,在終端中運行以下命令確認是否安裝成功。

```Plain%20Text node -v npx -v



若安裝成功,終端中會輸出已安裝的 Node.js 的版本號,例如:


```Plain%20Text
v18.19.0
10.2.0

安裝 uvx(Python 工具)

uvx 是 uv 提供的命令行工具,用于快速運行 Python 腳本。

  1. 前往 Python 官網(wǎng),下載并安裝 Python 3.8 或更高版本。
  2. 安裝完成后,在終端中執(zhí)行以下命令確認是否安裝成功。

    python --version

    若安裝成功,終端中會輸出已安裝的 Python 的版本號。

  3. 執(zhí)行以下命令,安裝 uv(包含 uvx)。安裝腳本會自動下載 uv 并放置到系統(tǒng)默認路徑中。

    • macOS / Linux 安裝命令:

    curl -LsSf https://astral.sh/uv/install.sh | sh

    • Windows 安裝命令(PowerShell):

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  4. 執(zhí)行以下命令,驗證是否安裝成功。

    uvx --version

    若安裝成功,終端中會輸出已安裝的 uvx 的版本號。

配置 MCP Server

你可以直接從市場中添加合適的 MCP Server,或手動配置。

方式一:從市場添加

MCP 市場中提供了社區(qū)中熱門的 MCP Server,你可以將它們添加到項目中。

  1. 在 AI 對話窗口的右上角,點擊 設置 圖標 > MCP。

    界面上顯示 MCP 窗口。

  2. 點擊 + 添加 按鈕。

    你將前往 MCP Server 市場。

  3. 從列表中找到所需的 MCP Server,然后點擊右側(cè)的 + 按鈕。
  4. 配置該 MCP Server:

    普通 MCP 服務器 標為“輕松配置”的MCP服務器
    將 MCP 服務器介紹頁面中的 JSON 配置內(nèi)容粘貼至輸入框中,然后將 env 信息(例如 API Key、Token、Access Key 等字段)替換為真實信息。  
     >提示:優(yōu)先使用 NPX 或 UVX 配置。  
    填寫該 MCP Server 所要求的信息。  

  5. 點擊 確認 按鈕。

    該 MCP Server 已配置完成。

方式二:手動配置

如果在市場中無法找到想要的 MCP Server,或者想使用自己開發(fā)的 MCP Server,則需要手動配置。

  1. 在 AI 對話窗口的右上角,點擊 設置 圖標 > MCP。

    界面上顯示 MCP 窗口。

  2. 點擊 + 添加 按鈕。

    你已進入 MCP Server 市場。

  3. 點擊 手動配置。

    界面上顯示 手動配置 窗口。

  4. 配置 MCP 服務器。

    提示
    優(yōu)先使用 NPX 或 UVX 配置。

    • 若你希望添加一個全新的 MCP Server,將 JSON 配置內(nèi)容填入輸入框中,然后點擊 確認 按鈕。該 MCP Server 將被添加至 MCP 列表中。
    • 若你已在其他 IDE 中配置了 MCP Server,并希望在 Trae IDE 中復用。你可以點擊 原始配置(JSON) 按鈕,然后將 MCP Server 的 JSON 配置內(nèi)容粘貼至 Trae IDE 的 mcp.json 文件中。粘貼完成后,MCP 列表中將自動添加相應的 MCP Server。

在智能體中使用 MCP Server

將 MCP Server 添加至智能體,讓其調(diào)用 MCP Server 中的工具來更好地處理你的需求。

內(nèi)置智能體:Builder with MCP

Builder with MCP 是 Trae IDE 的內(nèi)置智能體,所有已配置的 MCP Server 都將被自動添加至該智能體,且不可編輯。

提示
使用 Builder with MCP 時,若遇到拒絕回答的情況,則可以在自定義智能體中使用 MCP Server。

自定義智能體

你可以將 MCP Server 添加到自定義智能體中進行使用,由智能體自動調(diào)用 MCP Server 中的工具來完成任務。創(chuàng)建智能體時,你可以為其添加 MCP Server。詳情參考《智能體》。

管理 MCP Server

你可以編輯或刪除 MCP Server。

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號