加载中
构建我们的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 的参数字典为这些参数提供值。然后服务器会生成将您的值替换到相应位置的完整提示。

测试实现效果
实现完成后,您可以通过CLI测试提示。当您输入斜杠时,可用的提示会以命令形式出现。选择像"format"这样的提示会提示您为任何必需参数选择值(例如选择要格式化的文档)。系统随后会:
- 检索已插值您的参数的提示
- 将完整提示发送给Claude
- Claude执行任何必要的工具调用以满足请求
- 返回格式化后的结果

提示在实践中的应用
提示定义了客户端可以调用的可复用的用户和助手消息集。它们应该是高质量的、经过充分测试的,并且与您的MCP服务器的用途相关。将它们视为预构建的工作流,结合您服务器的工具和资源来完成特定任务。
提示系统在提示逻辑(在服务器上定义)和执行(由客户端和Claude处理)之间创建了清晰的分离。这使得创建用户可以通过简单命令触发的复杂、多步骤工作流变得容易。