載入中
載入中

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

實作列出提示

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

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

取得個別提示

get_prompt 方法比較有趣,因為它會處理參數插值。當我們請求特定提示時,我們傳遞的引數會被注入到提示函式中。舉例來說,如果我們的伺服器有一個「format」提示,該提示預期接收一個 doc_id 參數,該值就會被傳遞並插入到實際的提示文字中。

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 的對話。

實際測試提示

當您執行客戶端並輸入斜線時,您會看到可用的提示以指令的形式列出。選擇像「format」這樣的提示會提示您從可用文件中選擇。接著系統會:

  • 取出已插入文件 ID 的提示
  • 將其直接以使用者訊息的形式餵給 Claude
  • Claude 同時收到指示與文件 ID
  • Claude 使用可用工具取得文件內容
  • Claude 回覆重新格式化後的結果

在客戶端輸入斜線會列出「/format」,它會以 Markdown 格式重寫文件的內容。

提示如何運作

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

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

工作流程如下:

  1. 撰寫並評估與您的 MCP 伺服器目的相關的提示
  2. 使用 @mcp.prompt 裝飾器在您的 MCP 伺服器中定義該提示
  3. 您的客戶端可以隨時請求該提示
  4. 請求提示時,提供會以關鍵字引數形式傳遞給提示函式的引數
  5. 該函式使用這些引數來自訂提示內容

這套系統建立了可重複使用、可參數化的提示,能夠在不同的客戶端與使用情境間共用,讓您的 MCP 伺服器更加多用途且強大。