載入中
建立我們的 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 的參數字典會為這些參數提供值。伺服器接著會產生完整的提示,並將您的值替換到適當的位置。

測試實作結果
實作完成後,您可以透過 CLI 測試提示。當您輸入斜線時,可用的提示會以命令的形式出現。選擇像「format」這樣的提示,系統會提示您為任何必要參數選擇值(例如選擇要格式化的文件)。接著系統會:
- 擷取內插了您參數的提示
- 將完整的提示傳送給 Claude
- Claude 執行任何必要的工具呼叫以完成請求
- 回傳格式化後的結果

實務中的提示
提示定義了客戶端可以叫用的可重複使用使用者與助理訊息集合。它們應該是高品質、經過充分測試,並且與您 MCP 伺服器的目的相關。可以將它們想像成預先建構好的工作流程,結合您伺服器的工具與資源以完成特定任務。
提示系統在提示邏輯(於伺服器端定義)與執行(由客戶端和 Claude 處理)之間建立了清楚的分離。這使得建立複雜的多步驟工作流程變得容易,使用者可以透過簡單的命令觸發這些工作流程。