提示词 (Prompts) - 模型上下文协议

协议修订: 2025-11-25

模型上下文协议 (MCP) 为服务器向客户端开放提示词模板提供了一种标准化的方式。提示词允许服务器提供结构化的消息和指令，用于与语言模型进行交互。客户端可以发现可用的提示词、检索其内容，并提供参数对其进行自定义。

用户交互模型

提示词被设计为由用户控制，这意味着它们由服务器开放给客户端，目的是让用户能够显式地选择使用它们。通常，提示词会通过用户界面中用户发起的命令来触发，这使得用户能够自然地发现并调用可用的提示词。例如，作为斜杠命令：

Example of prompt exposed as slash command

然而，实现者可以自由地通过任何适合其需求的界面模式来开放提示词——协议本身并不强制要求任何特定的用户交互模型。

功能

支持提示词的服务器必须在初始化期间声明 prompts 能力

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

listChanged 表示当可用提示词列表发生变化时，服务器是否会发出通知。

协议消息

列出提示词

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

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

响应

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "prompts": [
      {
        "name": "code_review",
        "title": "Request Code Review",
        "description": "Asks the LLM to analyze code quality and suggest improvements",
        "arguments": [
          {
            "name": "code",
            "description": "The code to review",
            "required": true
          }
        ],
        "icons": [
          {
            "src": "https://example.com/review-icon.svg",
            "mimeType": "image/svg+xml",
            "sizes": ["any"]
          }
        ]
      }
    ],
    "nextCursor": "next-page-cursor"
  }
}

获取提示词

要检索特定的提示词，客户端会发送 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": {
    "description": "Code review prompt",
    "messages": [
      {
        "role": "user",
        "content": {
          "type": "text",
          "text": "Please review this Python code:\ndef hello():\n    print('world')"
        }
      }
    ]
  }
}

列表变更通知

当可用提示词列表发生变化时，声明了 listChanged 能力的服务器应当发送通知

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

消息流

数据类型