Prompts in the client

📝 MCP 客户端与提示 (Prompt) 核心概念

一、 客户端功能实现 (Client Functionality)

• 列出提示 (List Prompts): 客户端需实现功能，用于从 MCP 服务器获取所有已定义的提示列表。
• 获取特定提示 (Get Prompt): 客户端调用此功能时，必须提供两个关键信息：
• 提示名称 (Prompt Name)。
• 所需参数 (Arguments)。

二、 提示机制与变量插值 (Prompt Mechanism & Variable Interpolation)

• 参数作用: 在获取单个提示时，客户端提供的参数（如 document_id）会被作为关键字参数 (Keyword Arguments) 传递给提示函数。
• 插值过程: 提示函数利用这些参数，将变量值填充到提示文本的相应位置（即实现变量插值）。
• 数据流: 客户端 → 调用 get_prompt → 服务器返回格式化后的消息 (result. messages) → 消息直接输入给云端 (Cloud/LLM) 进行处理。

三、 核心概念总结 (Core Concepts Recap)

• 定义与评估: 首先需要编写并评估一个与 MCP 服务器功能相关的提示（例如：文档重写）。
• 服务器定义: 将该提示定义在 MCP 服务器内部。
• 客户端调用: 客户端可以随时请求该提示。
• 参数传递: 客户端通过关键字参数向提示函数提供输入数据。
• 最终目标: 提示函数利用这些参数，生成最终的、可执行的指令（即格式化后的提示）。

Takeaways

• 客户端需实现获取提示列表和获取特定提示的功能，获取特定提示时必须提供提示名称和所需参数。
• 客户端提供的参数作为关键字参数传递给提示函数，用于驱动提示的执行。
• 提示函数利用这些参数执行变量插值，将变量值填充到提示文本的相应位置。
• 提示函数最终生成格式化后的消息，该消息直接输入给云端（LLM）进行处理。