Skip to main content
协议修订版：draft
引出是在此版本的MCP规范中新引入的，其设计可能在未来的协议版本中演变。
Model Context Protocol (MCP)提供了一种标准化的方式，允许服务器在交互期间通过客户端从用户请求额外信息。此流程允许客户端保持对用户交互和数据共享的控制，同时使服务器能够动态收集必要的信息。 服务器使用JSON模式从用户请求结构化数据以验证响应。

​
用户交互模型

MCP中的引出允许服务器通过启用嵌套在其他MCP服务器功能内部的用户输入请求来实施交互式工作流程。 实施可以自由地通过适合其需求的任何界面模式公开引出 - 协议本身不强制任何特定的用户交互模型。
为了信任、安全和安全性：
  • 服务器不得使用引出请求敏感信息。
应用程序应该：
  • 提供清楚显示哪个服务器正在请求信息的UI
  • 允许用户在发送前审查和修改其响应
  • 尊重用户隐私并提供明确的拒绝和取消选项

​
能力

支持引出的客户端必须在初始化期间声明elicitation能力： 
{
  "capabilities": {
    "elicitation": {}
  }
}

​
协议消息

​
创建引出请求

要从用户请求信息，服务器发送elicitation/create请求：

​
简单文本请求

请求： 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "elicitation/create",
  "params": {
    "message": "Please provide your GitHub username",
    "requestedSchema": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        }
      },
      "required": ["name"]
    }
  }
}
响应： 
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "action": "accept",
    "content": {
      "name": "octocat"
    }
  }
}

​
结构化数据请求

请求： 
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "elicitation/create",
  "params": {
    "message": "Please provide your contact information",
    "requestedSchema": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Your full name"
        },
        "email": {
          "type": "string",
          "format": "email",
          "description": "Your email address"
        },
        "age": {
          "type": "number",
          "minimum": 18,
          "description": "Your age"
        }
      },
      "required": ["name", "email"]
    }
  }
}
Response: 
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "action": "accept",
    "content": {
      "name": "Monalisa Octocat",
      "email": "[email protected]",
      "age": 30
    }
  }
}
拒绝响应示例： 
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "action": "decline"
  }
}
取消响应示例： 
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "action": "cancel"
  }
}

​
消息流程

​
请求模式

requestedSchema字段允许服务器使用JSON Schema的受限子集定义预期响应的结构。为了简化客户端用户体验，引出模式仅限于具有原始属性的平面对象： 
"requestedSchema": {
  "type": "object",
  "properties": {
    "propertyName": {
      "type": "string",
      "title": "Display Name",
      "description": "Description of the property"
    },
    "anotherProperty": {
      "type": "number",
      "minimum": 0,
      "maximum": 100
    }
  },
  "required": ["propertyName"]
}

​
支持的模式类型

模式仅限于这些原始类型：
  1. 字符串模式 
    {
  "type": "string",
  "title": "Display Name",
  "description": "Description text",
  "minLength": 3,
  "maxLength": 50,
  "pattern": "^[A-Za-z]+$",
  "format": "email",
  "default": "[email protected]"
}
    支持的格式：email、uri、date、date-time
  2. 数字模式 
    {
  "type": "number", // or "integer"
  "title": "Display Name",
  "description": "Description text",
  "minimum": 0,
  "maximum": 100,
  "default": 50
}
  3. 布尔模式 
    {
  "type": "boolean",
  "title": "Display Name",
  "description": "Description text",
  "default": false
}
  4. 枚举模式 
    {
  "type": "string",
  "title": "Display Name",
  "description": "Description text",
  "enum": ["option1", "option2", "option3"],
  "enumNames": ["Option 1", "Option 2", "Option 3"],
  "default": "option1"
}
客户端可以使用此模式来：
  1. 生成适当的输入表单
  2. 在发送前验证用户输入
  3. 为用户提供更好的指导
所有原始类型都支持可选的默认值以提供合理的起点。支持默认值的客户端应该使用这些值预填充表单字段。 请注意，复杂的嵌套结构、对象数组和其他高级JSON Schema功能被有意不支持，以简化客户端用户体验。

​
响应操作

引出响应使用三操作模型来清楚地区分不同的用户操作： 
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "action": "accept", // or "decline" or "cancel"
    "content": {
      "propertyName": "value",
      "anotherProperty": 42
    }
  }
}
三个响应操作是：
  1. 接受 (action: "accept")：用户明确批准并提交数据
    • content字段包含与请求模式匹配的提交数据
    • 示例：用户点击了”提交”、“确定”、“确认”等。
  2. 拒绝 (action: "decline")：用户明确拒绝了请求
    • content字段通常被省略
    • 示例：用户点击了”拒绝”、“拒绝”、“否”等。
  3. 取消 (action: "cancel")：用户在没有做出明确选择的情况下关闭
    • content字段通常被省略
    • 示例：用户关闭了对话框、点击外部、按下Escape等。
服务器应该适当处理每个状态：
  • 接受：处理提交的数据
  • 拒绝：处理明确拒绝（例如，提供替代方案）
  • 取消：处理关闭（例如，稍后再次提示）

​
安全考虑

  1. 服务器不得通过引出请求敏感信息
  2. 客户端应该实施用户批准控制
  3. 双方应该根据提供的模式验证引出内容
  4. 客户端应该清楚显示哪个服务器正在请求信息
  5. 客户端应该允许用户随时拒绝引出请求
  6. 客户端应该实施速率限制
  7. 客户端应该以清楚显示正在请求什么信息以及为什么的方式呈现引出请求