載入中

客戶端中的提示

第 56 課9 分鐘
載入中

MCP 中的提示定義了一組可供客戶端使用的使用者與助理訊息。這些提示應該是高品質、經過充分測試,並且與 MCP 伺服器的整體用途相關。

MCP 伺服器程式碼定義了一個名為「format」的提示,用於以 Markdown 格式重寫文件內容。

實作 List Prompts

第一步是在您的 MCP 客戶端中實作 list_prompts 方法。此方法會從伺服器擷取所有可用的提示:

python
async def list_prompts(self) -> list[types.Prompt]:
    result = await self.session().list_prompts()
    return result.prompts

這個簡單的實作會呼叫 session 的 list_prompts 方法,並從結果中回傳提示陣列。

取得個別提示

get_prompt 方法會擷取特定提示,並將引數內插到其中。當您請求一個提示時,您會提供引數,這些引數會以關鍵字引數的形式傳遞給提示函式:

python
async def get_prompt(self, prompt_name, args: dict[str, str]):
    result = await self.session().get_prompt(prompt_name, args)
    return result.messages

此方法會從結果中回傳訊息,這些訊息組成一段對話,可以直接餵給 Claude。

提示引數的運作方式

當您在伺服器端定義一個提示函式時,它可以接受參數。例如,一個文件格式化提示可能會預期一個 doc_id 參數:

python
def format_document(doc_id: str):
    # doc_id 會被插入到提示中

當客戶端呼叫 get_prompt 時,引數字典應該包含預期的鍵。MCP 伺服器會將這些引數作為關鍵字引數傳遞給提示函式,讓動態內容得以插入提示範本中。

在 CLI 中測試提示

實作完成後,您可以透過命令列介面測試提示。當您輸入斜線時,可用的提示會以命令的形式出現。選擇一個提示可能會提示您從可用選項(例如文件 ID)中進行選擇,接著完整的提示就會被傳送給 Claude。

終端機執行 uv run main.py,輸入了「/format plan.md」,並有一個檔案自動完成清單,plan.md 被高亮顯示。

工作流程如下所示:

  1. 使用者選擇一個提示(例如「format」)
  2. 系統提示輸入所需的引數(例如要格式化哪個文件)
  3. 提示會連同內插值一起傳送給 Claude
  4. 接著 Claude 可以使用工具來擷取額外資料並完成任務

終端機顯示的 Markdown,其中一個資源表格列寫著「Development Team 5 FTE Phases 1-5」,以及一個風險管理章節。

提示最佳實務

在為您的 MCP 伺服器建立提示時:

  • 讓它們與您伺服器的用途相關
  • 在部署前徹底測試它們
  • 使用清楚、明確的指示
  • 設計它們以與您可用的工具良好配合
  • 考慮使用者需要提供哪些引數

提示在預先定義的功能與動態的使用者需求之間架起了橋樑,為 Claude 提供了處理複雜任務的結構化起點,同時透過參數化維持了彈性。