載入中
載入中

建立我們的 MCP 客戶端的最後一步是實作提示功能。這讓我們能夠列出伺服器中所有可用的提示,並擷取特定提示,同時將變數內插到其中。

實作列出提示

list_prompts 方法相當直接。我們呼叫 session 的列出提示方法並回傳提示:

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

取得個別提示

get_prompt 方法更有趣,因為它處理參數內插。當我們請求特定提示時,我們會傳遞參數,這些參數會被注入提示函式中。例如,如果我們的伺服器有一個期望 doc_id 參數的「format」提示,我們會在參數字典中提供該值:

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。

提示參數如何運作

當您在 MCP 伺服器中定義提示函式時,任何參數都會變成可用的內插變數。您傳遞給 get_prompt 的參數字典會為這些參數提供值。伺服器接著會產生完整的提示,並將您的值替換到適當的位置。

mcp_server.py 程式碼定義了「format」提示:其 doc_id 參數被內插在 document_id 標籤之間。

測試實作結果

實作完成後,您可以透過 CLI 測試提示。當您輸入斜線時,可用的提示會以命令的形式出現。選擇像「format」這樣的提示,系統會提示您為任何必要參數選擇值(例如選擇要格式化的文件)。接著系統會:

  1. 擷取內插了您參數的提示
  2. 將完整的提示傳送給 Claude
  3. Claude 執行任何必要的工具呼叫以完成請求
  4. 回傳格式化後的結果

MCP 伺服器程式碼:@mcp.prompt 命名了一個「format」提示,該提示使用 format_document 函式以 Markdown 格式重寫文件。

實務中的提示

提示定義了客戶端可以叫用的可重複使用使用者與助理訊息集合。它們應該是高品質、經過充分測試,並且與您 MCP 伺服器的目的相關。可以將它們想像成預先建構好的工作流程,結合您伺服器的工具與資源以完成特定任務。

提示系統在提示邏輯(於伺服器端定義)與執行(由客戶端和 Claude 處理)之間建立了清楚的分離。這使得建立複雜的多步驟工作流程變得容易,使用者可以透過簡單的命令觸發這些工作流程。