Defining prompts

MCP 服务器中的提示 (Prompts) 核心概念

一、 核心功能与目标

• 功能实现： 在 MCP 服务器中实现斜杠命令（Slash Commands），例如 /format。
• 用户交互： 用户输入斜杠（/）时，系统会提供支持的命令自动补全列表。
• 自定义提示（Prompts）的目的：
• 允许服务器作者预先定义一套经过测试和评估的、高度专业化的提示。
• 目标是提供比用户手动输入更优秀、更定制化的结果，尤其是在服务器擅长的特定任务（如文档管理）中。
• 对比： 尽管用户可以自行完成任务，但自定义提示能确保输出质量达到最佳。

二、 提示的实现机制

• 定义方式： 使用 MCP 服务器中的提示装饰器（prompt decorator）来定义提示。
• 结构组成：
• 名称 (Name)： 为提示指定一个名称（如 format）。
• 描述 (Description)： 简要说明提示的功能。
• 函数实现： 编写一个函数来处理该提示的逻辑。
• 数据流：
• 提示函数接收参数（如 doc_id）。
• 函数返回一个消息列表（list of messages），该列表包含实际的“用户消息”和“助手消息”。
• 这些消息被发送给客户端/LLM 进行处理。

三、 工作流程示例 (以格式化文档为例)

• 用户操作： 用户在客户端输入 /format [文档ID]。
• 服务器响应： MCP 服务器调用预定义的 format 提示函数。
• 提示生成： 函数返回一个结构化的消息列表，其中包含完整的、经过参数插值（interpolation）优化的提示文本。
• LLM 执行： LLM 接收该消息列表，并根据提示执行任务（例如：读取文档内容 → 使用 Markdown 语法重写 → 编辑/保存文档）。
• 结果输出： 用户获得格式化后的文档内容。

Takeaways

• 自定义提示（Prompts）的核心目标是在MCP服务器中实现斜杠命令，通过预定义专业化的提示来确保输出质量达到最佳。
• 提示的实现机制是使用提示装饰器（prompt decorator）来定义，结构上包含名称、描述和处理逻辑的函数。
• 提示函数负责接收参数，并返回一个包含用户消息和助手消息的列表，作为指导LLM执行任务的结构化输入。
• 工作流程是：用户输入命令 → MCP服务器调用预定义的提示函数 → 函数生成优化后的提示文本 → LLM执行任务并输出结果。