加载中
加载中

构建我们的MCP客户端的最后一步是实现提示功能。这使我们能够列出服务器上所有可用的提示,并检索将变量插值其中的特定提示。

实现列出提示功能

list_prompts 方法很简单。我们调用会话的列出提示方法并返回这些提示:

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 命名了一个将文档以Markdown格式重写的"format"提示,带有一个format_document函数。

提示在实践中的应用

提示定义了客户端可以调用的可复用的用户和助手消息集。它们应该是高质量的、经过充分测试的,并且与您的MCP服务器的用途相关。将它们视为预构建的工作流,结合您服务器的工具和资源来完成特定任务。

提示系统在提示逻辑(在服务器上定义)和执行(由客户端和Claude处理)之间创建了清晰的分离。这使得创建用户可以通过简单命令触发的复杂、多步骤工作流变得容易。