提示词

Model Context Protocol (MCP) 提供了一种标准化方式，使服务器能够向客户端暴露提示词模板。提示词允许服务器提供结构化的消息和指令，以便与语言模型进行交互。客户端可以发现可用的提示词，检索其内容，并提供参数以自定义它们。

For brevity, the request examples on this page omit the _meta request metadata (io.modelcontextprotocol/protocolVersion, io.modelcontextprotocol/clientInfo, and io.modelcontextprotocol/clientCapabilities). Every request MUST include the required _meta fields; see _meta.

用户交互模型

提示词旨在成为用户控制的，这意味着它们从服务器暴露给客户端，目的是让用户能够明确选择使用它们。这指的是谁决定何时使用提示词，而不是谁编写其内容。提示词内容由服务器定义。通常，提示词将通过用户界面中用户发起的命令触发，这允许用户自然地发现并调用可用的提示词。例如，作为斜杠命令：然而，实现者可以自由地通过任何适合其需求的界面模式暴露提示词—协议本身并不强制任何特定的用户交互模型。

能力

支持提示词的服务器必须在其 DiscoverResult 中声明 prompts 能力：

{
  "capabilities": {
    "prompts": {
      "listChanged": true
    }
  }
}

listChanged 指示服务器是否将在可用提示词列表更改时发出通知。声明了 prompts 能力的服务器必须以当前对请求客户端可用的提示词集合响应 prompts/list 请求。该集合可以为空，也可以随时间变化（参见列表更改通知），但绝不能因连接而异，或因该连接上的其他请求而产生副作用。该集合可以随请求中提供的授权而变化——例如，仅返回调用方已获授权范围内允许的提示词——因为凭据是逐请求输入，而不是连接状态。

协议消息

列出提示词

要检索可用的提示词，客户端发送 prompts/list 请求。此操作支持分页和缓存。 请求：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "prompts/list",
  "params": {
    "cursor": "optional-cursor-value"
  }
}

响应：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "resultType": "complete",
    "prompts": [
      {
        "name": "code_review",
        "title": "请求代码审查",
        "description": "让 LLM 分析代码质量并提出改进建议",
        "arguments": [
          {
            "name": "code",
            "description": "要审查的代码",
            "required": true
          }
        ],
        "icons": [
          {
            "src": "https://example.com/review-icon.svg",
            "mimeType": "image/svg+xml",
            "sizes": ["any"]
          }
        ]
      }
    ],
    "nextCursor": "next-page-cursor",
    "ttlMs": 600000,
    "cacheScope": "public"
  }
}

获取提示词

要检索特定提示词，客户端发送 prompts/get 请求。参数可以通过补全 API 自动完成。 请求：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "prompts/get",
  "params": {
    "name": "code_review",
    "arguments": {
      "code": "def hello():\n    print('world')"
    }
  }
}

响应：

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "resultType": "complete",
    "description": "代码审查提示词",
    "messages": [
      {
        "role": "user",
        "content": {
          "type": "text",
          "text": "请审查这段 Python 代码：\ndef hello():\n    print('world')"
        }
      }
    ]
  }
}

服务器也可以对 prompts/get 返回一个 InputRequiredResult，表示在提示词能够被解析之前还需要额外输入。这遵循多轮往返请求机制。重试请求时，客户端会在请求参数中包含 inputResponses，以及如果服务器提供了的话，还会包含 requestState。

列表更改通知

当可用提示词列表发生变化时，声明了 listChanged 能力的服务器应该向已打开带有 promptsListChanged: true 的 subscriptions/listen 流的客户端发送通知：

{
  "jsonrpc": "2.0",
  "method": "notifications/prompts/list_changed"
}

消息流

数据类型

提示词定义包括：

name: 提示词的唯一标识符
title: 可选的用于显示目的的人类可读提示词名称。
description: 可选的人类可读描述
icons: 可选的用于用户界面显示的图标数组
arguments: 可选的用于自定义的参数列表

提示词消息

提示词中的消息可以包含：

role: “user” 或 “assistant” 以指示说话者
content: 以下内容类型之一：

提示消息中的所有内容类型都支持可选的 annotations，用于描述受众、优先级和修改时间等元数据。

文本内容

文本内容表示纯文本消息：

{
  "type": "text",
  "text": "消息的文本内容"
}

这是用于自然语言交互最常见的内容类型。

图像内容

图像内容允许在消息中包含视觉信息：

{
  "type": "image",
  "data": "base64 编码的图像数据",
  "mimeType": "image/png"
}

图像数据必须进行 base64 编码并包含有效的 MIME 类型。这使得在视觉上下文重要的多模态交互成为可能。

音频内容

音频内容允许在消息中包含音频信息：

{
  "type": "audio",
  "data": "base64 编码的音频数据",
  "mimeType": "audio/wav"
}

音频数据必须进行 base64 编码并包含有效的 MIME 类型。这使得在音频上下文重要的多模态交互成为可能。

资源链接

提示消息可以包含指向资源的链接，以在不直接嵌入资源内容的情况下提供额外上下文或数据。在这种情况下，提示消息返回一个可由客户端获取的 URI：

{
  "type": "resource_link",
  "uri": "file:///project/src/main.rs",
  "name": "main.rs",
  "description": "主要应用程序入口点",
  "mimeType": "text/x-rust"
}

资源链接支持与常规资源相同的资源注释，以帮助客户端理解如何使用它们。

嵌入资源

嵌入资源允许直接在消息中引用服务器端资源：

{
  "type": "resource",
  "resource": {
    "uri": "resource://example",
    "mimeType": "text/plain",
    "text": "资源内容"
  }
}

资源可以包含文本或二进制（blob）数据，并且必须包括：

有效的资源 URI
适当的 MIME 类型
文本内容或 base64 编码的 blob 数据

嵌入资源使提示词能够无缝地将服务器管理的内容（如文档、代码示例或其他参考材料）直接纳入对话流中。

错误处理

服务器应该为常见失败情况返回标准 JSON-RPC 错误：

无效的提示词名称：-32602（无效参数）
缺少必需参数：-32602（无效参数）
内部错误：-32603（内部错误）

实现注意事项

服务器应该在处理前验证提示词参数
客户端应该处理大型提示词列表的分页
双方应该遵守能力协商

安全性

实现必须仔细验证所有提示词输入和输出，以防止注入攻击或未经授权的资源访问。

基础协议

客户端功能

服务器功能

提示词

用户交互模型

能力

协议消息

列出提示词

获取提示词

列表更改通知

消息流

数据类型

提示词

提示词消息

文本内容

图像内容

音频内容

资源链接

嵌入资源

错误处理

实现注意事项

安全性

​用户交互模型

​能力

​协议消息

​列出提示词

​获取提示词

​列表更改通知

​消息流

​数据类型

​提示词

​提示词消息

​文本内容

​图像内容

​音频内容

​资源链接

​嵌入资源

​错误处理

​实现注意事项

​安全性

用户交互模型

能力

协议消息

列出提示词

获取提示词

列表更改通知

消息流

数据类型

提示词

提示词消息

文本内容

图像内容

音频内容

资源链接

嵌入资源

错误处理

实现注意事项

安全性