Defining prompts

MCP 服务器中的提示（Prompts）核心概念

• 提示（Prompts）的作用：
• 在 MCP 服务器中，提示是预先定义、经过测试和评估的、针对特定任务（如文档管理、重格式化）定制的指令集。
• 它们允许服务器暴露高度专业化的功能，供客户端（如 CLI 应用）调用。

• 实现机制：斜杠命令（Slash Commands）
• 用户通过输入斜杠（/）来触发应用程序支持的命令（例如：/format）。
• 系统会提供命令的自动补全列表，引导用户使用预设功能。

• 预定义提示的价值（核心目标）：
• 提升结果质量： 即使普通用户可以手动完成任务（如将文本转换为 Markdown），但通过使用服务器提供的、经过精心设计的提示，可以确保获得更优、更一致的输出。
• 专业化封装： 服务器作者可以预先编写和测试复杂的提示，将这些高质量的流程封装起来，用户无需了解底层逻辑即可使用。

• 技术实现步骤：
• 装饰器（Decorator）： 使用提示装饰器来定义服务器中的提示功能。
• 定义结构： 每个提示需要包含名称（Name）和可选的描述（Description）。
• 函数实现： 提示的实现是一个函数，它接收必要的参数（如文档 ID）。
• 返回消息列表： 该函数必须返回一个消息列表（List of Messages），这些消息（包含用户和助手消息）将被发送给云端 LLM 进行处理。

• 工作流程示例（以格式化文档为例）：
• 用户输入命令（例如：/format [文档ID]）。
• 服务器调用预设的提示函数。
• 提示内部逻辑：
• 利用工具获取文档内容。
• 指示 LLM 将内容重写为 Markdown 格式。
• 利用工具将更新后的内容保存回文档。

Takeaways

• 提示（Prompts）是MCP服务器中预定义、经过测试的指令集，用于将高度专业化的功能暴露给客户端调用。
• 用户通过输入斜杠命令（如/format）来触发和使用这些预设的提示功能。
• 核心目标是提升输出结果的质量和一致性，将复杂的底层流程封装起来，用户无需了解底层逻辑即可使用。
• 技术实现上，提示使用装饰器定义，其函数必须返回一个包含用户和助手消息的列表，供云端LLM进行处理。