搭配 Amazon Q Developer 使用 MCP - Amazon Q Developer
MCP 伺服器載入工具和提示主要優點MCP 架構核心 MCP 概念

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

搭配 Amazon Q Developer 使用 MCP

模型內容通訊協定 (MCP) 是一種開放標準，可讓 AI 助理與外部工具和服務互動。Amazon Q Developer CLI 現在支援 MCP，可讓您透過將其連接至自訂工具和服務來擴展 Q 的功能。

主題

MCP 伺服器載入

Amazon Q 會在背景載入 MCP 伺服器，讓您立即開始互動，而無需等待所有伺服器初始化。當其各自的伺服器完成載入時，工具逐步可用。

檢查伺服器狀態

您可以使用 /tools命令來查看哪些伺服器仍在載入中，以及哪些工具已經可用。

設定伺服器初始化

您可以使用下列方式自訂伺服器初始化逾時：

$ q settings mcp.initTimeout [value]

其中 [value]是以毫秒為單位的逾時。此設定會控制 Amazon Q 在允許您開始互動之前等待伺服器初始化的時間。

工具和提示

本節說明如何搭配 Amazon Q Developer CLI 使用 MCP 工具和提示。

了解 MCP 工具

MCP 工具是 MCP 伺服器向 Amazon Q Developer CLI 公開的可執行函數。它們可讓 Amazon Q Developer 代表您執行動作、處理資料，以及與外部系統互動。

MCP 中的每個工具都有：

  • 名稱：工具的唯一識別符

  • 描述：人類可讀取的工具功能描述

  • 輸入結構描述：定義工具接受之參數的 JSON 結構描述

  • 註釋：有關工具行為和效果的選用提示

探索可用的工具

若要查看 Q CLI 工作階段中有哪些可用的工具：

/tools

此命令會顯示所有可用的工具，包括內建工具和 MCP 伺服器提供的工具。

工具可以有不同的許可層級來決定它們的使用方式：

  • 自動核准：這些工具可在沒有明確許可的情況下用於每個調用

  • 需要核准：這些工具每次使用時都需要您的明確許可

  • 危險：這些工具標記為具有潛在風險，在核准之前需要仔細考慮

使用工具

您可以透過兩種方式使用 MCP 工具：

  1. 自然語言請求：只要描述您想要做什麼，Q 就會決定要使用哪個工具。

  2. 直接工具調用：您也可以明確要求 Q 使用特定工具。

使用提示

MCP 伺服器可以提供預先定義的提示，以協助引導特定任務中的 Q：

  • 列出可用的提示： /prompts

  • 使用提示：

    • @ prompt-name arg1 arg2

搭配引數使用提示的範例：

@fetch https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html

主要優點

  • 可擴展性：將 Amazon Q 連接到特定網域或工作流程的專用工具

  • 自訂：建立根據您的特定需求量身打造的自訂工具

  • 生態系統整合：利用不斷成長的 MCP 相容工具生態系統

  • 標準化：使用多個 AI 助理支援的一致通訊協定

  • 彈性：MCP 可讓您在不同 LLM 供應商之間切換，同時維持相同的工具整合

  • 安全性：使用本機 MCP 伺服器將資料保留在基礎設施中

MCP 架構

MCP 遵循用戶端伺服器架構，其中：

  • MCP 主機：想要透過 MCP 存取資料的 Amazon Q 開發人員 CLI 等程式

  • MCP 用戶端：與伺服器維持 1：1 連線的通訊協定用戶端

  • MCP 伺服器：透過標準化模型內容通訊協定公開特定功能的輕量型程式

  • 本機資料來源：MCP 伺服器可安全存取的電腦檔案、資料庫和服務

  • 遠端服務：MCP 伺服器可透過網際網路 （例如，透過 APIs) 連線的外部系統

範例 MCP 通訊流程

  User
   |
   v
+------------------+     +-----------------+     +------------------+
|                  |     |                 |     |                  |
| Amazon Q Dev     | --> | MCP Client API  | --> | MCP Server       |
|                  |     |                 |     |                  |
+------------------+     +-----------------+     +------------------+
                                                        |
                                                        v
                                                 +------------------+
                                                 |                  |
                                                 | External Service |
                                                 |                  |
                                                 +------------------+

使用者、Amazon Q Developer CLI 和透過 MCP 的外部服務之間的通訊流程

核心 MCP 概念

工具

工具是 MCP 伺服器向用戶端公開的可執行函數。它們允許 Amazon Q：

  • 在外部系統中執行動作

  • 以專門的方式處理資料

  • 與 APIs和服務互動

  • 代表您執行命令

工具的定義包含唯一名稱、描述、輸入結構描述 （使用 JSON 結構描述），以及有關工具行為的選用註釋。

提示

提示是預先定義的範本，可協助在特定任務中引導 Amazon Q。他們可以：

  • 接受動態引數

  • 包含來自 資源的內容

  • 鏈結多個互動

  • 引導特定工作流程

  • 表面為 UI 元素 （例如斜線命令）

資源

資源代表 MCP 伺服器可提供給 Amazon Q 的資料，例如：

  • 檔案內容

  • 資料庫記錄

  • API 回應

  • 文件

  • 組態資料