指任何可从传输线上解码或编码后发送的有效 JSON-RPC 对象。
不期望响应的通知。
期望响应的请求。
对请求的响应，包含结果或错误。
对请求的成功（非错误）响应。
供客户端使用的可选注释。客户端可以使用注释来辅助决定对象如何被使用或显示。
描述此对象或数据的预期受众。
可包含多个条目，用于表示内容对多个受众有用（例如 \["user", "assistant"]）。
描述此数据对服务器运行的重要程度。
值为 1 表示“最重要”，并表示该数据实际上是必需的；值为 0 表示“最不重要”，并表示该数据完全可选。
资源最后一次修改的时间，以 ISO 8601 格式字符串表示。
应为 ISO 8601 格式字符串（例如 "2025-01-12T15:00:58Z"）。
示例：打开文件中的最后活动时间戳、资源附加时的时间戳等。
用于表示分页游标的不透明令牌。
表示成功但不携带数据的结果。
可在用户界面中显示、可选指定尺寸的图标。
指向图标资源的标准 URI。可以是 HTTP/HTTPS URL，也可以是带有 Base64 编码图像数据的 data: URI。
使用方 SHOULD 采取措施，确保提供图标的 URL 来自与客户端/服务器相同的域或受信任域。
使用方在使用 SVG 时 SHOULD 采取适当的预防措施，因为 SVG 可能包含可执行 JavaScript。
当源 MIME 类型缺失或过于宽泛时，可选地覆盖 MIME 类型。例如："image/png"、"image/jpeg" 或 "image/svg+xml"。
可选的字符串数组，用于指定图标可使用的尺寸。每个字符串应采用 WxH 格式（例如 "48x48"、"96x96"），对于 SVG 等可缩放格式则使用 "any"。
如果未提供，客户端应假定该图标可用于任意尺寸。
可选说明此图标设计面向的主题。"light" 表示该图标设计用于浅色背景，"dark" 表示该图标设计用于深色背景。
如果未提供，客户端应假定该图标可用于任何主题。
任何请求的通用参数。
日志消息的严重级别。
这些级别映射到 RFC-5424 中规定的 syslog 消息严重级别：[https://datatracker.ietf.org/doc/html/rfc5424#section-6.2.1](https://datatracker.ietf.org/doc/html/rfc5424#section-6.2.1)
自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
表示 \_meta 字段的内容，客户端和服务器使用该字段为其交互附加额外元数据。
某些键名由 MCP 保留用于协议级元数据；实现 MUST NOT 对这些键上的值作出假设。此外，特定 schema 定义可按其声明为特定用途的元数据保留特定名称。
有效键包含两个部分：
前缀：
.）分隔的标签，后跟斜杠（/）。-）。com.example/，而不是 example.com/）。modelcontextprotocol 或 mcp 的任何前缀都为 MCP 使用而保留。例如：io.modelcontextprotocol/、dev.mcp/、org.modelcontextprotocol.api/ 和 com.mcp.tools/ 都是保留的。但是，com.example.mcp/ 不是保留的，因为第二个标签是 example。名称：
\[a-z0-9A-Z]）开头和结尾。-）、下划线（\_）或点（.）。更多详情请参见通用字段：\_meta。
任何通知的通用参数。
分页请求的通用参数。
表示当前分页位置的不透明令牌。如果提供，服务器应返回从该游标之后开始的结果。
进度令牌，用于将进度通知与原始请求关联。
JSON-RPC 中用于唯一标识请求的 ID。
使用额外的请求专用字段扩展 MetaObject。MetaObject 的所有键命名规则均适用。
\_meta，用于了解更多详情。如果指定，调用方请求接收此请求的带外进度通知（由 notifications/progress 表示）。该参数的值是不透明令牌，将附加到任何后续通知中。接收方没有义务提供这些通知。
此请求使用的 MCP 协议版本。必需。
对于 HTTP 传输，此值 MUST 与 MCP-Protocol-Version 标头匹配；否则服务器 MUST 返回 400 Bad Request。如果服务器不支持请求的版本，则 MUST 返回 UnsupportedProtocolVersionError。
标识发出请求的客户端软件。必需。
Implementation schema 要求包含 name 和 version；其他字段可选。
客户端针对此特定请求的能力。必需。
能力按请求声明，而不是在初始化时只声明一次；空对象表示客户端不支持任何可选能力。服务器 MUST NOT 根据之前的请求推断能力。
此请求期望的日志级别。可选。
如果不存在，服务器 MUST NOT 为此请求发送任何 notifications/message 通知。客户端通过显式设置级别来选择接收日志消息。取代以前的 logging/setLevel RPC。
自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
任何请求的通用参数。
通用结果字段。
表示结果的类型，使客户端能够确定如何解析结果对象。
实现此协议版本的服务器 MUST 包含此字段。为了向后兼容，当客户端从实现较早协议版本的服务器收到结果（其中不包含 resultType）时，客户端 MUST 将缺失字段视为 "complete"。
表示 Result 对象的类型，使客户端能够确定如何解析响应。
complete - 请求已成功完成，结果包含最终内容。 input\_required - 请求需要额外输入，结果包含一个 InputRequiredResult 对象，其中包含让客户端在重试原始请求前提供额外输入的指令。
对话中消息和数据的发送方或接收方。
发生的错误类型。
错误的简短描述。消息 SHOULD 限制为简洁的单句。
关于错误的附加信息。此成员的值由发送方定义（例如详细错误信息、嵌套错误等）。
表示接收方发生内部错误的 JSON-RPC 错误。当接收方遇到阻止其完成请求的意外状况时返回此错误。
错误的简短描述。消息 SHOULD 限制为简洁的单句。
关于错误的附加信息。此成员的值由发送方定义（例如详细错误信息、嵌套错误等）。
发生的错误类型。
表示方法参数无效或格式不正确的 JSON-RPC 错误。
在 MCP 中，当请求参数验证失败时，会在多种上下文中返回此错误：
错误的简短描述。消息 SHOULD 限制为简洁的单句。
关于错误的附加信息。此成员的值由发送方定义（例如详细错误信息、嵌套错误等）。
发生的错误类型。
表示请求不是有效请求对象的 JSON-RPC 错误。当消息结构不符合 JSON-RPC 2.0 规范对请求的要求时返回此错误（例如缺少 jsonrpc 或 method 等必需字段，或这些字段使用了无效类型）。
错误的简短描述。消息 SHOULD 限制为简洁的单句。
关于错误的附加信息。此成员的值由发送方定义（例如详细错误信息、嵌套错误等）。
发生的错误类型。
表示所请求方法不存在或不可用的 JSON-RPC 错误。
在 MCP 中，当客户端调用服务器未实现的方法时，服务器会返回此错误——该方法可能是真正未知的方法，也可能受服务器未声明的能力限制（例如在未声明 prompts 能力时调用 prompts/list）。
如果请求需要客户端未声明的客户端能力，则改用 MissingRequiredClientCapabilityError（-32003）表示。
错误的简短描述。消息 SHOULD 限制为简洁的单句。
关于错误的附加信息。此成员的值由发送方定义（例如详细错误信息、嵌套错误等）。
发生的错误类型。
当服务器需要某项客户端能力，而该能力未在请求的 clientCapabilities 中声明时返回的错误代码。
当处理请求需要客户端未在 clientCapabilities 中声明的能力时返回。对于 HTTP，响应状态码 MUST 为 400 Bad Request。
表示服务器收到了无效 JSON 的 JSON-RPC 错误。当服务器无法解析消息的 JSON 文本时返回此错误。
错误的简短描述。消息 SHOULD 限制为简洁的单句。
关于错误的附加信息。此成员的值由发送方定义（例如详细错误信息、嵌套错误等）。
发生的错误类型。
当服务器不支持请求的协议版本时返回的错误代码。
当请求的协议版本对服务器未知或不受支持时返回（例如服务器选择不实现的已知实验版或草案版本）。对于 HTTP，响应状态码 MUST 为 400 Bad Request。
提供给 LLM 或由 LLM 提供的音频。
Base64 编码的音频数据。
音频的 MIME 类型。不同提供商可能支持不同的音频类型。
供客户端使用的可选注释。
此资源的 URI。
此资源的 MIME 类型（如果已知）。
表示该项二进制数据的 Base64 编码字符串。
嵌入到提示或工具调用结果中的资源内容。
客户端自行决定如何最佳地渲染嵌入资源，以便 LLM 和/或用户使用。
供客户端使用的可选注释。
提供给 LLM 或由 LLM 提供的图像。
Base64 编码的图像数据。
图像的 MIME 类型。不同提供商可能支持不同的图像类型。
供客户端使用的可选注释。
服务器能够读取并包含在提示或工具调用结果中的资源。
注意：工具返回的资源链接不保证会出现在 resources/list 请求的结果中。
客户端可在用户界面中显示的一组带尺寸图标，可选。
支持渲染图标的客户端 MUST 至少支持以下 MIME 类型：
image/png - PNG 图像（安全，通用兼容）image/jpeg（以及 image/jpg）- JPEG 图像（安全，通用兼容）支持渲染图标的客户端 SHOULD 也支持：
image/svg+xml - SVG 图像（可缩放但需要安全预防措施）image/webp - WebP 图像（现代、高效格式）用于程序化或逻辑用途，但在以往规范或回退场景中（如果 title 不存在）也用作显示名称。
用于 UI 和最终用户上下文——优化为人类可读且易于理解，即使读者不熟悉特定领域术语。
如果未提供，应使用 name 进行显示（但对于 Tool，如果存在 annotations.title，则应优先于 name 使用）。
此资源的 URI。
对此资源所表示内容的描述。
客户端可使用此信息改进 LLM 对可用资源的理解。可将其视为给模型的“提示”。
此资源的 MIME 类型（如果已知）。
供客户端使用的可选注释。
原始资源内容的大小（以字节为单位，即 Base64 编码或任何分词之前），如果已知。
Host 可使用此信息显示文件大小并估算上下文窗口使用量。
提供给 LLM 或由 LLM 提供的文本。
消息的文本内容。
供客户端使用的可选注释。
此资源的 URI。
此资源的 MIME 类型（如果已知）。
该项的文本。仅当该项确实可以表示为文本（而非二进制数据）时才必须设置。
客户端发送给服务器、用于请求补全选项的请求。
\{
"jsonrpc": "2.0",
"id": "completion-example",
"method": "completion/complete",
"params": \{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
},
"ref": \{
"type": "ref/prompt",
"name": "code\_review"
},
"argument": \{
"name": "language",
"value": "py"
}
}
} completion/complete 请求的参数。
\{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
},
"ref": \{
"type": "ref/prompt",
"name": "code\_review"
},
"argument": \{
"name": "language",
"value": "py"
}
} \{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
},
"ref": \{
"type": "ref/prompt",
"name": "code\_review"
},
"argument": \{
"name": "framework",
"value": "fla"
},
"context": \{
"arguments": \{
"language": "python"
}
}
} 参数的信息。
参数的名称。
用于补全匹配的参数值。
用于补全的额外可选上下文。
Optionalarguments?: \{ \[key: string]: string }URI 模板或提示中先前已解析的变量。
服务器针对 completion/complete 请求返回的结果。
表示结果的类型，使客户端能够确定如何解析结果对象。
实现此协议版本的服务器 MUST 包含此字段。为了向后兼容，当客户端从实现较早协议版本的服务器收到结果（其中不包含 resultType）时，客户端 MUST 将缺失字段视为 "complete"。
补全值数组。不得超过 100 项。
Optionaltotal?: number可用补全选项总数。该数量可能超过响应中实际发送的值数量。
OptionalhasMore?: boolean表示除当前响应中提供的补全选项外是否还有更多选项，即使确切总数未知。
标识一个提示。
用于程序化或逻辑用途，但在以往规范或回退场景中（如果 title 不存在）也用作显示名称。
用于 UI 和最终用户上下文——优化为人类可读且易于理解，即使读者不熟悉特定领域术语。
如果未提供，应使用 name 进行显示（但对于 Tool，如果存在 annotations.title，则应优先于 name 使用）。
对资源或资源模板定义的引用。
资源的 URI 或 URI 模板。
服务器通过客户端向用户引出额外信息的请求。
\{
"method": "elicitation/create",
"params": \{
"mode": "form",
"message": "Please provide your GitHub username",
"requestedSchema": \{
"type": "object",
"properties": \{
"name": \{
"type": "string",
"title": "GitHub Username",
"description": "Your GitHub username"
}
},
"required": \["name"]
}
}
} 通过客户端向用户引出额外信息的请求参数。
客户端针对 elicitation/create 请求返回的结果。
用户对引出的响应动作。
"accept"：用户提交了表单/确认了操作"decline"：用户明确拒绝了操作"cancel"：用户在未作出明确选择的情况下关闭提交的表单数据，仅在 action 为 "accept" 且 mode 为 "form" 时存在。包含与请求 schema 匹配的值。对于带外模式响应则省略。
通过客户端中的表单向用户引出非敏感信息的请求参数。
\{
"mode": "form",
"message": "Please provide your GitHub username",
"requestedSchema": \{
"type": "object",
"properties": \{
"name": \{
"type": "string"
}
},
"required": \["name"]
}
} \{
"mode": "form",
"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"]
}
} 引出模式。
向用户展示的消息，用于描述正在请求哪些信息。
JSON Schema 的受限子集。仅允许顶层属性，不允许嵌套。
通过客户端中的 URL 向用户引出信息的请求参数。
引出模式。
向用户展示的消息，用于解释为什么需要此次交互。
引出的 ID，在服务器上下文中必须唯一。客户端 MUST 将此 ID 视为不透明值。
用户应导航到的 URL。
请改用 TitledSingleSelectEnumSchema。此接口将在未来版本中移除。
（旧版）枚举值的显示名称。根据 JSON Schema 2020-12，这不是标准用法。
受限的 schema 定义，仅允许原始类型，不包含嵌套对象或数组。
多选枚举的 schema，每个选项都有显示标题。
\{
"type": "array",
"title": "Color Selection",
"description": "Choose your favorite colors",
"minItems": 1,
"maxItems": 2,
"items": \{
"anyOf": \[
\{ "const": "#FF0000", "title": "Red" },
\{ "const": "#00FF00", "title": "Green" },
\{ "const": "#0000FF", "title": "Blue" }
]
},
"default": \["#FF0000", "#00FF00"]
} 枚举字段的可选标题。
枚举字段的可选描述。
要选择的最少项数。
要选择的最多项数。
数组项的 schema，包含枚举选项和显示标签。
包含值和显示标签的枚举选项数组。
可选默认值。
单选枚举的 schema，每个选项都有显示标题。
枚举字段的可选标题。
枚举字段的可选描述。
包含值和显示标签的枚举选项数组。
枚举值。
此选项的显示标签。
可选默认值。
不带选项显示标题的多选枚举 schema。
枚举字段的可选标题。
枚举字段的可选描述。
要选择的最少项数。
要选择的最多项数。
数组项的 schema。
可供选择的枚举值数组。
可选默认值。
不带选项显示标题的单选枚举 schema。
枚举字段的可选标题。
枚举字段的可选描述。
可供选择的枚举值数组。
可选默认值。
任一方都可以发送此通知，表示正在取消先前发出的请求。
该请求 SHOULD 仍处于进行中，但由于通信延迟，此通知始终 MAY 在请求已经完成后到达。
此通知表示结果将不会被使用，因此任何相关处理 SHOULD 停止。
notifications/cancelled 通知的参数。
要取消的请求 ID。
这 MUST 对应同一方向上先前发出请求的 ID。
描述取消原因的可选字符串。该字符串 MAY 被记录或展示给用户。
从服务器传递给客户端的日志消息 JSONRPCNotification。客户端通过在请求的 \_meta 中设置 "io.modelcontextprotocol/logLevel" 来选择接收。
自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
notifications/message 通知的参数。
自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
此日志消息的严重级别。
发出此消息的日志记录器的可选名称。
要记录的数据，例如字符串消息或对象。这里允许任何可 JSON 序列化的类型。
用于向接收方告知长时间运行请求进度更新的带外通知。
notifications/progress 通知的参数。
初始请求中给出的进度令牌，用于将此通知与正在进行的请求关联。
到目前为止的进度。即使总量未知，每次取得进展时该值也应增加。
要处理的总项数（或所需总进度），如果已知。
描述当前进度的可选消息。
服务器发送给客户端的可选通知，告知其提供的提示列表已更改。服务器可以在客户端没有任何先前订阅的情况下发出此通知。
服务器发送给客户端的可选通知，告知其可读取的资源列表已更改。服务器可以在客户端没有任何先前订阅的情况下发出此通知。
服务器发送给客户端的通知，告知某个资源已更改并且可能需要重新读取。仅针对客户端通过 subscriptions/listen 请求中的 resourceSubscriptions 字段选择接收的资源发送。
notifications/resources/updated 通知的参数。
已更新资源的 URI。这可能是客户端实际订阅资源的子资源。
由服务器作为 subscriptions/listen 流上的第一条消息发送，用于确认订阅已建立，并报告其同意履行哪些通知类型。
服务器同意履行的请求通知类型子集。仅包含服务器实际支持的通知类型；如果客户端请求了不支持的类型（例如服务器没有提示时的 promptsListChanged），该类型会从此集合中省略。
服务器发送给客户端的可选通知，告知其提供的工具列表已更改。服务器可以在客户端没有任何先前订阅的情况下发出此通知。
服务器发送给客户端的可选通知，告知带外引出请求已完成。
已完成引出的 ID。
客户端必须满足的服务器发起请求映射。键是服务器分配的标识符；值是请求对象。
\{
"github\_login": \{
"method": "elicitation/create",
"params": \{
"mode": "form",
"message": "Please provide your GitHub username",
"requestedSchema": \{
"type": "object",
"properties": \{
"name": \{
"type": "string"
}
},
"required": \["name"]
}
}
},
"capital\_of\_france": \{
"method": "sampling/createMessage",
"params": \{
"messages": \[
\{
"role": "user",
"content": \{
"type": "text",
"text": "What is the capital of France?"
}
}
],
"maxTokens": 100
}
}
} 服务器发送的 InputRequiredResult，表示在请求完成前需要额外输入。
inputRequests 或 requestState 中至少一个 MUST 存在。
\{
"resultType": "input\_required",
"inputRequests": \{
"github\_login": \{
"method": "elicitation/create",
"params": \{
"message": "Please provide your GitHub username",
"requestedSchema": \{
"type": "object",
"properties": \{
"name": \{
"type": "string"
}
},
"required": \["name"]
}
}
},
"capital\_of\_france": \{
"method": "sampling/createMessage",
"params": \{
"messages": \[
\{
"role": "user",
"content": \{
"type": "text",
"text": "What is the capital of France?"
}
}
],
"maxTokens": 100
}
}
},
"requestState": "eyJsb2NhdGlvbiI6Ik5ldyBZb3JrIn0"
} 表示结果的类型，使客户端能够确定如何解析结果对象。
实现此协议版本的服务器 MUST 包含此字段。为了向后兼容，当客户端从实现较早协议版本的服务器收到结果（其中不包含 resultType）时，客户端 MUST 将缺失字段视为 "complete"。
客户端对服务器发起请求的响应映射。键对应 InputRequests 映射中的键；值是客户端对每个请求的结果。
客户端用于获取服务器提供的提示。
\{
"jsonrpc": "2.0",
"id": "get-prompt-example",
"method": "prompts/get",
"params": \{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
},
"name": "code\_review",
"arguments": \{
"code": "def hello():\n print('world')"
}
}
} prompts/get 请求的参数。
\{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
},
"name": "code\_review",
"arguments": \{
"code": "def hello():\n print('world')"
}
} 提示或提示模板的名称。
用于模板化提示的参数。
服务器针对 prompts/get 请求返回的成功响应。
服务器针对 prompts/get 请求返回的结果。
表示结果的类型，使客户端能够确定如何解析结果对象。
实现此协议版本的服务器 MUST 包含此字段。为了向后兼容，当客户端从实现较早协议版本的服务器收到结果（其中不包含 resultType）时，客户端 MUST 将缺失字段视为 "complete"。
提示的可选描述。
客户端发送，用于请求服务器拥有的提示和提示模板列表。
\{
"jsonrpc": "2.0",
"id": "list-prompts-example",
"method": "prompts/list",
"params": \{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
}
}
} 服务器针对 prompts/list 请求返回的成功响应。
\{
"jsonrpc": "2.0",
"id": "list-prompts-example",
"result": \{
"resultType": "complete",
"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](https://example.com/review-icon.svg)",
"mimeType": "image/svg+xml",
"sizes": \["any"]
}
]
}
],
"nextCursor": "next-page-cursor",
"ttlMs": 600000,
"cacheScope": "public"
}
} 服务器针对 prompts/list 请求返回的结果。
\{
"resultType": "complete",
"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](https://example.com/review-icon.svg)",
"mimeType": "image/svg+xml",
"sizes": \["any"]
}
]
}
],
"nextCursor": "next-page-cursor",
"ttlMs": 600000,
"cacheScope": "public"
} 表示结果的类型，使客户端能够确定如何解析结果对象。
实现此协议版本的服务器 MUST 包含此字段。为了向后兼容，当客户端从实现较早协议版本的服务器收到结果（其中不包含 resultType）时，客户端 MUST 将缺失字段视为 "complete"。
表示最后一个返回结果之后分页位置的不透明令牌。如果存在，可能还有更多结果可用。
服务器提供的提示，表示客户端在重新获取前 MAY 缓存此响应多长时间（以毫秒为单位）。语义类似于 HTTP Cache-Control max-age。
表示缓存响应的预期范围，类似于 HTTP Cache-Control: public 与 Cache-Control: private。
"public"：任何客户端或中介（例如共享网关、代理）MAY 缓存响应并将其提供给任何用户。"private"：只有发出请求用户的客户端 MAY 缓存响应。共享缓存（例如多租户网关）MUST NOT 将缓存副本提供给其他用户。服务器提供的提示或提示模板。
客户端可在用户界面中显示的一组带尺寸图标，可选。
支持渲染图标的客户端 MUST 至少支持以下 MIME 类型：
image/png - PNG 图像（安全，通用兼容）image/jpeg（以及 image/jpg）- JPEG 图像（安全，通用兼容）支持渲染图标的客户端 SHOULD 也支持：
image/svg+xml - SVG 图像（可缩放但需要安全预防措施）image/webp - WebP 图像（现代、高效格式）用于程序化或逻辑用途，但在以往规范或回退场景中（如果 title 不存在）也用作显示名称。
用于 UI 和最终用户上下文——优化为人类可读且易于理解，即使读者不熟悉特定领域术语。
如果未提供，应使用 name 进行显示（但对于 Tool，如果存在 annotations.title，则应优先于 name 使用）。
对此提示所提供内容的可选描述。
用于模板化提示的参数列表。
描述提示可接受的参数。
用于程序化或逻辑用途，但在以往规范或回退场景中（如果 title 不存在）也用作显示名称。
用于 UI 和最终用户上下文——优化为人类可读且易于理解，即使读者不熟悉特定领域术语。
如果未提供，应使用 name 进行显示（但对于 Tool，如果存在 annotations.title，则应优先于 name 使用）。
参数的人类可读描述。
是否必须提供此参数。
客户端发送，用于请求服务器拥有的资源列表。
\{
"jsonrpc": "2.0",
"id": "list-resources-example",
"method": "resources/list",
"params": \{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
}
}
} 服务器针对 resources/list 请求返回的成功响应。
\{
"jsonrpc": "2.0",
"id": "list-resources-example",
"result": \{
"resultType": "complete",
"resources": \[
\{
"uri": "file:///project/src/main.rs",
"name": "main.rs",
"title": "Rust Software Application Main File",
"description": "Primary application entry point",
"mimeType": "text/x-rust",
"icons": \[
\{
"src": "[https://example.com/rust-file-icon.png](https://example.com/rust-file-icon.png)",
"mimeType": "image/png",
"sizes": \["48x48"]
}
]
}
],
"nextCursor": "eyJwYWdlIjogM30=",
"ttlMs": 600000,
"cacheScope": "private"
}
} 服务器针对 resources/list 请求返回的结果。
\{
"resultType": "complete",
"resources": \[
\{
"uri": "file:///project/src/main.rs",
"name": "main.rs",
"title": "Rust Software Application Main File",
"description": "Primary application entry point",
"mimeType": "text/x-rust",
"icons": \[
\{
"src": "[https://example.com/rust-file-icon.png](https://example.com/rust-file-icon.png)",
"mimeType": "image/png",
"sizes": \["48x48"]
}
]
}
],
"nextCursor": "eyJwYWdlIjogM30=",
"ttlMs": 600000,
"cacheScope": "private"
} 表示结果的类型，使客户端能够确定如何解析结果对象。
实现此协议版本的服务器 MUST 包含此字段。为了向后兼容，当客户端从实现较早协议版本的服务器收到结果（其中不包含 resultType）时，客户端 MUST 将缺失字段视为 "complete"。
表示最后一个返回结果之后分页位置的不透明令牌。如果存在，可能还有更多结果可用。
服务器提供的提示，表示客户端在重新获取前 MAY 缓存此响应多长时间（以毫秒为单位）。语义类似于 HTTP Cache-Control max-age。
表示缓存响应的预期范围，类似于 HTTP Cache-Control: public 与 Cache-Control: private。
"public"：任何客户端或中介（例如共享网关、代理）MAY 缓存响应并将其提供给任何用户。"private"：只有发出请求用户的客户端 MAY 缓存响应。共享缓存（例如多租户网关）MUST NOT 将缓存副本提供给其他用户。服务器能够读取的已知资源。
客户端可在用户界面中显示的一组带尺寸图标，可选。
支持渲染图标的客户端 MUST 至少支持以下 MIME 类型：
image/png - PNG 图像（安全，通用兼容）image/jpeg（以及 image/jpg）- JPEG 图像（安全，通用兼容）支持渲染图标的客户端 SHOULD 也支持：
image/svg+xml - SVG 图像（可缩放但需要安全预防措施）image/webp - WebP 图像（现代、高效格式）用于程序化或逻辑用途，但在以往规范或回退场景中（如果 title 不存在）也用作显示名称。
用于 UI 和最终用户上下文——优化为人类可读且易于理解，即使读者不熟悉特定领域术语。
如果未提供，应使用 name 进行显示（但对于 Tool，如果存在 annotations.title，则应优先于 name 使用）。
此资源的 URI。
对此资源所表示内容的描述。
客户端可使用此信息改进 LLM 对可用资源的理解。可将其视为给模型的“提示”。
此资源的 MIME 类型（如果已知）。
供客户端使用的可选注释。
原始资源内容的大小（以字节为单位，即 Base64 编码或任何分词之前），如果已知。
Host 可使用此信息显示文件大小并估算上下文窗口使用量。
客户端发送给服务器，用于读取特定资源 URI。
\{
"jsonrpc": "2.0",
"id": "read-resource-example",
"method": "resources/read",
"params": \{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
},
"uri": "file:///project/src/main.rs"
}
} resources/read 请求的参数。
资源的 URI。URI 可以使用任何协议；如何解释由服务器决定。
服务器针对 resources/read 请求返回的成功响应。
\{
"jsonrpc": "2.0",
"id": "read-resource-example",
"result": \{
"resultType": "complete",
"contents": \[
\{
"uri": "file:///project/src/main.rs",
"mimeType": "text/x-rust",
"text": "fn main() \{\n println!(\\"Hello world!\\");\n}"
}
]
}
} \{
"jsonrpc": "2.0",
"id": "read-resource-with-ttl-example",
"result": \{
"resultType": "complete",
"contents": \[
\{
"uri": "file:///project/src/main.rs",
"mimeType": "text/x-rust",
"text": "fn main() \{\n println!(\\"Hello world!\\");\n}"
}
],
"ttlMs": 60000,
"cacheScope": "private"
}
} 服务器针对 resources/read 请求返回的结果。
表示结果的类型，使客户端能够确定如何解析结果对象。
实现此协议版本的服务器 MUST 包含此字段。为了向后兼容，当客户端从实现较早协议版本的服务器收到结果（其中不包含 resultType）时，客户端 MUST 将缺失字段视为 "complete"。
服务器提供的提示，表示客户端在重新获取前 MAY 缓存此响应多长时间（以毫秒为单位）。语义类似于 HTTP Cache-Control max-age。
表示缓存响应的预期范围，类似于 HTTP Cache-Control: public 与 Cache-Control: private。
"public"：任何客户端或中介（例如共享网关、代理）MAY 缓存响应并将其提供给任何用户。"private"：只有发出请求用户的客户端 MAY 缓存响应。共享缓存（例如多租户网关）MUST NOT 将缓存副本提供给其他用户。客户端发送，用于请求服务器拥有的资源模板列表。
\{
"jsonrpc": "2.0",
"id": "list-resource-templates-example",
"method": "resources/templates/list",
"params": \{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
}
}
} 服务器针对 resources/templates/list 请求返回的成功响应。
\{
"jsonrpc": "2.0",
"id": "list-resource-templates-example",
"result": \{
"resultType": "complete",
"resourceTemplates": \[
\{
"uriTemplate": "file:///\{path}",
"name": "Project Files",
"title": "Project Files",
"description": "Access files in the project directory",
"mimeType": "application/octet-stream",
"icons": \[
\{
"src": "[https://example.com/folder-icon.png](https://example.com/folder-icon.png)",
"mimeType": "image/png",
"sizes": \["48x48"]
}
]
}
],
"ttlMs": 3600000,
"cacheScope": "public"
}
} 服务器针对 resources/templates/list 请求返回的结果。
\{
"resultType": "complete",
"resourceTemplates": \[
\{
"uriTemplate": "file:///\{path}",
"name": "Project Files",
"title": "📁 Project Files",
"description": "Access files in the project directory",
"mimeType": "application/octet-stream",
"icons": \[
\{
"src": "[https://example.com/folder-icon.png](https://example.com/folder-icon.png)",
"mimeType": "image/png",
"sizes": \["48x48"]
}
]
}
],
"nextCursor": "next-page-cursor",
"ttlMs": 3600000,
"cacheScope": "public"
} 表示结果的类型，使客户端能够确定如何解析结果对象。
实现此协议版本的服务器 MUST 包含此字段。为了向后兼容，当客户端从实现较早协议版本的服务器收到结果（其中不包含 resultType）时，客户端 MUST 将缺失字段视为 "complete"。
表示最后一个返回结果之后分页位置的不透明令牌。如果存在，可能还有更多结果可用。
服务器提供的提示，表示客户端在重新获取前 MAY 缓存此响应多长时间（以毫秒为单位）。语义类似于 HTTP Cache-Control max-age。
表示缓存响应的预期范围，类似于 HTTP Cache-Control: public 与 Cache-Control: private。
"public"：任何客户端或中介（例如共享网关、代理）MAY 缓存响应并将其提供给任何用户。"private"：只有发出请求用户的客户端 MAY 缓存响应。共享缓存（例如多租户网关）MUST NOT 将缓存副本提供给其他用户。服务器上可用资源的模板描述。
客户端可在用户界面中显示的一组带尺寸图标，可选。
支持渲染图标的客户端 MUST 至少支持以下 MIME 类型：
image/png - PNG 图像（安全，通用兼容）image/jpeg（以及 image/jpg）- JPEG 图像（安全，通用兼容）支持渲染图标的客户端 SHOULD 也支持：
image/svg+xml - SVG 图像（可缩放但需要安全预防措施）image/webp - WebP 图像（现代、高效格式）用于程序化或逻辑用途，但在以往规范或回退场景中（如果 title 不存在）也用作显示名称。
用于 UI 和最终用户上下文——优化为人类可读且易于理解，即使读者不熟悉特定领域术语。
如果未提供，应使用 name 进行显示（但对于 Tool，如果存在 annotations.title，则应优先于 name 使用）。
可用于构造资源 URI 的 URI 模板（依据 RFC 6570）。
对此模板用途的描述。
客户端可使用此信息改进 LLM 对可用资源的理解。可将其视为给模型的“提示”。
匹配此模板的所有资源的 MIME 类型。仅当所有匹配此模板的资源具有相同类型时才应包含。
供客户端使用的可选注释。
服务器发送，用于向客户端请求根 URI 列表。根目录允许服务器请求可操作的特定目录或文件。根目录的常见示例是提供一组服务器应操作的仓库或目录。
当服务器需要了解文件系统结构，或访问客户端有权限读取的特定位置时，通常使用此请求。
自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
客户端针对 roots/list 请求返回的结果。此结果包含一个 Root 对象数组，每个对象表示服务器可操作的根目录或文件。
\{
"roots": \[
\{
"uri": "file:///home/user/repos/frontend",
"name": "Frontend Repository"
},
\{
"uri": "file:///home/user/repos/backend",
"name": "Backend Repository"
}
]
} 自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
表示服务器可操作的根目录或文件。
自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
标识根目录的 URI。目前它必须以 file:// 开头。未来协议版本可能会放宽此限制，以允许其他 URI 方案。
根目录的可选名称。可用于为根目录提供人类可读标识符，这对显示用途或在应用程序其他部分引用根目录可能有用。
服务器通过客户端对 LLM 进行采样的请求。客户端可完全自行决定选择哪个模型。客户端还应在开始采样前通知用户，使其能够检查请求（人在环路中）并决定是否批准。
\{
"method": "sampling/createMessage",
"params": \{
"messages": \[
\{
"role": "user",
"content": \{
"type": "text",
"text": "What is the capital of France?"
}
}
],
"modelPreferences": \{
"hints": \[
\{
"name": "claude-3-sonnet"
}
],
"intelligencePriority": 0.8,
"speedPriority": 0.5
},
"systemPrompt": "You are a helpful assistant.",
"maxTokens": 100
}
} 自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
sampling/createMessage 请求的参数。
\{
"messages": \[
\{
"role": "user",
"content": \{
"type": "text",
"text": "What is the capital of France?"
}
}
],
"modelPreferences": \{
"hints": \[
\{
"name": "claude-3-sonnet"
}
],
"intelligencePriority": 0.8,
"speedPriority": 0.5
},
"systemPrompt": "You are a helpful assistant.",
"maxTokens": 100
} \{
"messages": \[
\{
"role": "user",
"content": \{
"type": "text",
"text": "What's the weather like in Paris and London?"
}
}
],
"tools": \[
\{
"name": "get\_weather",
"description": "Get current weather for a city",
"inputSchema": \{
"type": "object",
"properties": \{
"city": \{
"type": "string",
"description": "City name"
}
},
"required": \["city"]
}
}
],
"toolChoice": \{
"mode": "auto"
},
"maxTokens": 1000
} \{
"messages": \[
\{
"role": "user",
"content": \{
"type": "text",
"text": "What's the weather like in Paris and London?"
}
},
\{
"role": "assistant",
"content": \[
\{
"type": "tool\_use",
"id": "call\_abc123",
"name": "get\_weather",
"input": \{ "city": "Paris" }
},
\{
"type": "tool\_use",
"id": "call\_def456",
"name": "get\_weather",
"input": \{ "city": "London" }
}
]
},
\{
"role": "user",
"content": \[
\{
"type": "tool\_result",
"toolUseId": "call\_abc123",
"content": \[
\{
"type": "text",
"text": "Weather in Paris: 18°C, partly cloudy"
}
]
},
\{
"type": "tool\_result",
"toolUseId": "call\_def456",
"content": \[
\{
"type": "text",
"text": "Weather in London: 15°C, rainy"
}
]
}
]
}
],
"tools": \[
\{
"name": "get\_weather",
"description": "Get current weather for a city",
"inputSchema": \{
"type": "object",
"properties": \{
"city": \{ "type": "string" }
},
"required": \["city"]
}
}
],
"maxTokens": 1000
} 自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
服务器对模型选择的偏好。客户端 MAY 忽略这些偏好。
服务器希望用于采样的可选系统提示。客户端 MAY 修改或省略此提示。
请求包含来自一个或多个 MCP 服务器（包括调用方）的上下文，并将其附加到提示中。客户端 MAY 忽略此请求。
默认值为 "none"。"thisServer" 和 "allServers" 值已弃用（SEP-2596）：服务器 SHOULD 省略此字段或使用 "none"，并且 SHOULD 仅在客户端声明 ClientCapabilities.sampling.context 时使用已弃用的值。
"thisServer" 和 "allServers" 值自协议版本 2025-11-25（SEP-2596）起弃用，并且最晚会随采样功能本身（SEP-2577）一起移除。请省略此字段或使用 "none"。
请求采样的最大 token 数（用于防止补全失控）。
客户端 MAY 选择采样少于请求上限的 token。
传递给 LLM 提供商的可选元数据。此元数据的格式由提供商决定。
模型在生成期间可使用的工具。如果提供了此字段但未声明 ClientCapabilities.sampling.tools，客户端 MUST 返回错误。
控制模型如何使用工具。如果提供了此字段但未声明 ClientCapabilities.sampling.tools，客户端 MUST 返回错误。默认值为 \{ mode: "auto" }。
客户端针对 sampling/createMessage 请求返回的结果。客户端应在返回采样消息前通知用户，使其能够检查响应（人在环路中）并决定是否允许服务器看到它。
\{
"role": "assistant",
"content": \{
"type": "text",
"text": "The capital of France is Paris."
},
"model": "claude-3-sonnet-20240307",
"stopReason": "endTurn"
} \{
"role": "assistant",
"content": \[
\{
"type": "tool\_use",
"id": "call\_abc123",
"name": "get\_weather",
"input": \{
"city": "Paris"
}
},
\{
"type": "tool\_use",
"id": "call\_def456",
"name": "get\_weather",
"input": \{
"city": "London"
}
}
],
"model": "claude-3-sonnet-20240307",
"stopReason": "toolUse"
} \{
"role": "assistant",
"content": \{
"type": "text",
"text": "Based on the current weather data:\n\n- \*\*Paris\*\*: 18°C and partly cloudy - quite pleasant!\n- \*\*London\*\*: 15°C and rainy - you'll want an umbrella.\n\nParis has slightly warmer and drier conditions today."
},
"model": "claude-3-sonnet-20240307",
"stopReason": "endTurn"
} 自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
生成该消息的模型名称。
采样停止的原因（如果已知）。
标准值：
"endTurn"：助手回合自然结束"stopSequence"：遇到停止序列"maxTokens"：达到最大 token 限制"toolUse"：模型希望使用一个或多个工具此字段是开放字符串，用于允许提供商特定的停止原因。
用于模型选择的提示。
此处未声明的键目前在规范中未指定，由客户端解释。
自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
模型名称提示。
客户端 SHOULD 将其视为模型名称的子字符串；例如：
claude-3-5-sonnet 应匹配 claude-3-5-sonnet-20241022sonnet 应匹配 claude-3-5-sonnet-20241022、claude-3-sonnet-20240229 等。claude 应匹配任何 Claude 模型只要用途相近，客户端 MAY 也可将该字符串映射到其他提供商的模型名称或不同模型系列；例如：
gemini-1.5-flash 可匹配 claude-3-haiku-20240307服务器在采样期间向客户端请求的模型选择偏好。
由于 LLM 可能在多个维度上存在差异，选择“最佳”模型很少是直接明了的。不同模型擅长不同方面——有些更快但能力较弱，有些能力更强但更昂贵，等等。此接口允许服务器表达多个维度上的优先级，帮助客户端为其用例做出适当选择。
这些偏好始终仅供参考。客户端 MAY 忽略它们。客户端也自行决定如何解释这些偏好，以及如何将其与其他考虑因素进行权衡。
\{
"hints": \[
\{ "name": "claude-3-sonnet" },
\{ "name": "claude" }
],
"costPriority": 0.3,
"speedPriority": 0.8,
"intelligencePriority": 0.5
} 自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
用于模型选择的可选提示。
如果指定了多个提示，客户端 MUST 按顺序评估它们（采用第一个匹配项）。
客户端 SHOULD 优先考虑这些提示而非数值优先级，但 MAY 仍使用优先级从模糊匹配中进行选择。
选择模型时对成本的优先程度。值为 0 表示成本不重要，值为 1 表示成本是最重要的因素。
选择模型时对采样速度（延迟）的优先程度。值为 0 表示速度不重要，值为 1 表示速度是最重要的因素。
选择模型时对智能和能力的优先程度。值为 0 表示智能不重要，值为 1 表示智能是最重要的因素。
描述发送给 LLM API 或从 LLM API 接收的消息。
\{
"role": "user",
"content": \{
"type": "text",
"text": "What is the capital of France?"
}
} \{
"role": "user",
"content": \[
\{
"type": "tool\_result",
"toolUseId": "call\_123",
"content": \[\{ "type": "text", "text": "Result 1" }]
},
\{
"type": "tool\_result",
"toolUseId": "call\_456",
"content": \[\{ "type": "text", "text": "Result 2" }]
}
]
} 自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
控制采样请求的工具选择行为。
自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
控制模型使用工具的能力：
"auto"：模型决定是否使用工具（默认）"required"：模型 MUST 在完成前使用至少一个工具"none"：模型 MUST NOT 使用任何工具工具使用的结果，由用户提供回助手。
\{
"type": "tool\_result",
"toolUseId": "call\_abc123",
"content": \[
\{
"type": "text",
"text": "Weather in Paris: 18°C, partly cloudy"
}
]
} 自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
此结果对应的工具使用 ID。
这 MUST 与先前 ToolUseContent 中的 ID 匹配。
工具使用的非结构化结果内容。
其格式与 CallToolResult.content 相同，可包含文本、图像、音频、资源链接和嵌入资源。
可选的结构化结果值。
可以是任何 JSON 值（对象、数组、字符串、数字、布尔值或 null）。如果工具定义了 Tool.outputSchema，则此值 SHOULD 符合该 schema。
工具使用是否产生错误。
如果为 true，内容通常描述发生的错误。 默认值：false
关于工具结果的可选元数据。客户端在后续采样请求中包含工具结果时 SHOULD 保留此字段，以启用缓存优化。
助手发出的调用工具请求。
\{
"type": "tool\_use",
"id": "call\_abc123",
"name": "get\_weather",
"input": \{
"city": "Paris"
}
} 自协议版本 2026-07-28（SEP-2577）起弃用。将在规范中至少保留十二个月；请参见已弃用功能注册表。
此工具使用的唯一标识符。
此 ID 用于将工具结果与对应的工具使用进行匹配。
要调用的工具名称。
传递给工具的参数，符合该工具的输入 schema。
关于工具使用的可选元数据。客户端在后续采样请求中包含工具使用时 SHOULD 保留此字段，以启用缓存优化。
客户端请求服务器公布其支持的协议版本、能力和其他元数据的请求。服务器 MUST 实现 server/discover。客户端 MAY 调用它，但不是必需的——版本协商也可以通过每个请求的 \_meta 内联发生。
\{
"jsonrpc": "2.0",
"id": "discover-1",
"method": "server/discover",
"params": \{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
}
}
} 服务器针对 server/discover 请求返回的结果。
\{
"resultType": "complete",
"supportedVersions": \["2026-07-28"],
"capabilities": \{
"tools": \{},
"resources": \{}
},
"serverInfo": \{
"name": "ExampleServer",
"version": "1.0.0"
},
"instructions": "This server provides weather and resource utilities. Prefer \`get\_weather\` for forecast lookups.",
"ttlMs": 3600000,
"cacheScope": "public"
} 表示结果的类型，使客户端能够确定如何解析结果对象。
实现此协议版本的服务器 MUST 包含此字段。为了向后兼容，当客户端从实现较早协议版本的服务器收到结果（其中不包含 resultType）时，客户端 MUST 将缺失字段视为 "complete"。
此服务器支持的 MCP 协议版本。客户端应从此列表中选择一个版本用于后续请求。
服务器的能力。
关于服务器软件实现的信息。
描述服务器及其功能的自然语言指导。
客户端可使用此信息改进 LLM 对可用工具的理解（例如将其包含在系统提示中）。它应专注于帮助模型有效使用服务器的信息，并且不应重复工具描述中已有的信息。
服务器提供的提示，表示客户端在重新获取前 MAY 缓存此响应多长时间（以毫秒为单位）。语义类似于 HTTP Cache-Control max-age。
表示缓存响应的预期范围，类似于 HTTP Cache-Control: public 与 Cache-Control: private。
"public"：任何客户端或中介（例如共享网关、代理）MAY 缓存响应并将其提供给任何用户。"private"：只有发出请求用户的客户端 MAY 缓存响应。共享缓存（例如多租户网关）MUST NOT 将缓存副本提供给其他用户。客户端可能支持的能力。已知能力在此 schema 中定义，但这不是封闭集合：任何客户端都可以定义自己的附加能力。
客户端支持的实验性非标准能力。
如果客户端支持列出根目录，则存在。
如果客户端支持从 LLM 采样，则存在。
客户端是否支持通过 includeContext 参数包含上下文。如果未声明，服务器 SHOULD 只使用 includeContext: "none"（或省略它）。
客户端是否支持通过 tools 和 toolChoice 参数使用工具。
如果客户端支持来自服务器的引出，则存在。
客户端支持的可选 MCP 扩展。键是扩展标识符（例如 "io.modelcontextprotocol/oauth-client-credentials"），值是每个扩展的设置对象。空对象表示支持但没有设置。
键 MUST 遵循 \_meta 键命名规则，并带有强制前缀。
描述 MCP 实现。
客户端可在用户界面中显示的一组带尺寸图标，可选。
支持渲染图标的客户端 MUST 至少支持以下 MIME 类型：
image/png - PNG 图像（安全，通用兼容）image/jpeg（以及 image/jpg）- JPEG 图像（安全，通用兼容）支持渲染图标的客户端 SHOULD 也支持：
image/svg+xml - SVG 图像（可缩放但需要安全预防措施）image/webp - WebP 图像（现代、高效格式）用于程序化或逻辑用途，但在以往规范或回退场景中（如果 title 不存在）也用作显示名称。
用于 UI 和最终用户上下文——优化为人类可读且易于理解，即使读者不熟悉特定领域术语。
如果未提供，应使用 name 进行显示（但对于 Tool，如果存在 annotations.title，则应优先于 name 使用）。
此实现的版本。
对此实现功能的人类可读可选描述。
客户端或服务器可使用此信息提供有关其用途和能力的上下文。例如，服务器可描述其提供的资源或工具类型，而客户端可描述其预期用例。
此实现网站的可选 URL。
服务器可能支持的能力。已知能力在此 schema 中定义，但这不是封闭集合：任何服务器都可以定义自己的附加能力。
服务器支持的实验性非标准能力。
如果服务器支持向客户端发送日志消息，则存在。
如果服务器支持参数自动补全建议，则存在。
如果服务器提供任何提示模板，则存在。
OptionallistChanged?: boolean此服务器是否支持提示列表更改通知。
如果服务器提供任何可读取资源，则存在。
Optionalsubscribe?: boolean此服务器是否支持订阅资源更新。
OptionallistChanged?: boolean此服务器是否支持资源列表更改通知。
如果服务器提供任何可调用工具，则存在。
OptionallistChanged?: boolean此服务器是否支持工具列表更改通知。
服务器支持的可选 MCP 扩展。键是扩展标识符（例如 "io.modelcontextprotocol/tasks"），值是每个扩展的设置对象。空对象表示支持但没有设置。
键 MUST 遵循 \_meta 键命名规则，并带有强制前缀。
客户端发送，用于打开一个长生命周期通道，以接收特定请求上下文之外的通知。取代之前的 HTTP GET 端点，并确保 HTTP 与 STDIO 之间行为一致。
\{
"jsonrpc": "2.0",
"id": "listen-1",
"method": "subscriptions/listen",
"params": \{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
},
"notifications": \{
"toolsListChanged": true,
"resourceSubscriptions": \["file:///project/config.json"]
}
}
} subscriptions/listen 请求的参数。
客户端在此流上选择接收的通知。服务器 MUST NOT 发送客户端未明确请求的通知类型。
客户端可在 subscriptions/listen 请求中选择接收的通知类型集合。
每种通知类型都是选择接收；服务器 MUST NOT 发送客户端未在此明确请求的通知类型。
如果为 true，则接收 notifications/tools/list\_changed。
如果为 true，则接收 notifications/prompts/list\_changed。
如果为 true，则接收 notifications/resources/list\_changed。
为这些资源 URI 订阅 notifications/resources/updated。取代以前的 resources/subscribe RPC。
客户端用于调用服务器提供的工具。
\{
"jsonrpc": "2.0",
"id": "call-tool-example",
"method": "tools/call",
"params": \{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
},
"name": "get\_weather",
"arguments": \{
"location": "New York"
}
}
} tools/call 请求的参数。
\{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
},
"name": "get\_weather",
"arguments": \{
"location": "New York"
}
} \{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{},
"progressToken": "oivaizmir"
},
"name": "build\_simulation",
"arguments": \{
"city": "Micropolis"
}
} 工具的名称。
用于工具调用的参数。
服务器针对 tools/call 请求返回的成功响应。
服务器针对 tools/call 请求返回的结果。
\{
"resultType": "complete",
"content": \[
\{
"type": "text",
"text": "Current weather in New York:\nTemperature: 72°F\nConditions: Partly cloudy"
}
],
"isError": false
} 表示结果的类型，使客户端能够确定如何解析结果对象。
实现此协议版本的服务器 MUST 包含此字段。为了向后兼容，当客户端从实现较早协议版本的服务器收到结果（其中不包含 resultType）时，客户端 MUST 将缺失字段视为 "complete"。
表示工具调用非结构化结果的内容对象列表。
表示工具调用结构化结果的可选 JSON 值。
可以是任何 JSON 值（对象、数组、字符串、数字、布尔值或 null），如果定义了工具的 outputSchema，则该值符合它。
工具调用是否以错误结束。
如果未设置，则假定为 false（调用成功）。
任何源自工具的错误 SHOULD 在结果对象内部报告，并将 isError 设置为 true，不要作为 MCP 协议级错误响应报告。否则，LLM 将无法看到发生了错误并自行纠正。
但是，任何查找工具时的错误、表示服务器不支持工具调用的错误，或任何其他异常情况，都应作为 MCP 错误响应报告。
客户端发送，用于请求服务器拥有的工具列表。
\{
"jsonrpc": "2.0",
"id": "list-tools-example",
"method": "tools/list",
"params": \{
"\_meta": \{
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientInfo": \{
"name": "ExampleClient",
"version": "1.0.0"
},
"io.modelcontextprotocol/clientCapabilities": \{}
}
}
} 服务器针对 tools/list 请求返回的成功响应。
\{
"jsonrpc": "2.0",
"id": "list-tools-example",
"result": \{
"resultType": "complete",
"tools": \[
\{
"name": "get\_weather",
"title": "Weather Information Provider",
"description": "Get current weather information for a location",
"inputSchema": \{
"type": "object",
"properties": \{
"location": \{
"type": "string",
"description": "City name or zip code"
}
},
"required": \["location"]
},
"icons": \[
\{
"src": "[https://example.com/weather-icon.png](https://example.com/weather-icon.png)",
"mimeType": "image/png",
"sizes": \["48x48"]
}
]
}
],
"nextCursor": "next-page-cursor",
"ttlMs": 3600000,
"cacheScope": "public"
}
} 服务器针对 tools/list 请求返回的结果。
\{
"resultType": "complete",
"tools": \[
\{
"name": "get\_weather",
"title": "Weather Information Provider",
"description": "Get current weather information for a location",
"inputSchema": \{
"type": "object",
"properties": \{
"location": \{
"type": "string",
"description": "City name or zip code"
}
},
"required": \["location"]
},
"icons": \[
\{
"src": "[https://example.com/weather-icon.png](https://example.com/weather-icon.png)",
"mimeType": "image/png",
"sizes": \["48x48"]
}
]
}
],
"nextCursor": "next-page-cursor",
"ttlMs": 300000,
"cacheScope": "public"
} 表示结果的类型，使客户端能够确定如何解析结果对象。
实现此协议版本的服务器 MUST 包含此字段。为了向后兼容，当客户端从实现较早协议版本的服务器收到结果（其中不包含 resultType）时，客户端 MUST 将缺失字段视为 "complete"。
表示最后一个返回结果之后分页位置的不透明令牌。如果存在，可能还有更多结果可用。
服务器提供的提示，表示客户端在重新获取前 MAY 缓存此响应多长时间（以毫秒为单位）。语义类似于 HTTP Cache-Control max-age。
表示缓存响应的预期范围，类似于 HTTP Cache-Control: public 与 Cache-Control: private。
"public"：任何客户端或中介（例如共享网关、代理）MAY 缓存响应并将其提供给任何用户。"private"：只有发出请求用户的客户端 MAY 缓存响应。共享缓存（例如多租户网关）MUST NOT 将缓存副本提供给其他用户。客户端可调用工具的定义。
\{
"name": "calculate\_sum",
"description": "Add two numbers",
"inputSchema": \{
"type": "object",
"properties": \{
"a": \{ "type": "number" },
"b": \{ "type": "number" }
},
"required": \["a", "b"]
}
} \{
"name": "calculate\_sum",
"description": "Add two numbers",
"inputSchema": \{
"\$schema": "[http://json-schema.org/draft-07/schema#](http://json-schema.org/draft-07/schema#)",
"type": "object",
"properties": \{
"a": \{ "type": "number" },
"b": \{ "type": "number" }
},
"required": \["a", "b"]
}
} \{
"name": "get\_current\_time",
"description": "Returns the current server time",
"inputSchema": \{
"type": "object",
"additionalProperties": false
}
} \{
"name": "get\_weather\_data",
"title": "Weather Data Retriever",
"description": "Get current weather data for a location",
"inputSchema": \{
"type": "object",
"properties": \{
"location": \{
"type": "string",
"description": "City name or zip code"
}
},
"required": \["location"]
},
"outputSchema": \{
"type": "object",
"properties": \{
"temperature": \{
"type": "number",
"description": "Temperature in celsius"
},
"conditions": \{
"type": "string",
"description": "Weather conditions description"
},
"humidity": \{
"type": "number",
"description": "Humidity percentage"
}
},
"required": \["temperature", "conditions", "humidity"]
}
} 客户端可在用户界面中显示的一组带尺寸图标，可选。
支持渲染图标的客户端 MUST 至少支持以下 MIME 类型：
image/png - PNG 图像（安全，通用兼容）image/jpeg（以及 image/jpg）- JPEG 图像（安全，通用兼容）支持渲染图标的客户端 SHOULD 也支持：
image/svg+xml - SVG 图像（可缩放但需要安全预防措施）image/webp - WebP 图像（现代、高效格式）用于程序化或逻辑用途，但在以往规范或回退场景中（如果 title 不存在）也用作显示名称。
用于 UI 和最终用户上下文——优化为人类可读且易于理解，即使读者不熟悉特定领域术语。
如果未提供，应使用 name 进行显示（但对于 Tool，如果存在 annotations.title，则应优先于 name 使用）。
工具的人类可读描述。
客户端可使用此信息改进 LLM 对可用工具的理解。可将其视为给模型的“提示”。
定义工具预期参数的 JSON Schema 对象。
工具参数始终是 JSON 对象，因此根级别需要 type: "object"。除此之外，任何 JSON Schema 2020-12 关键字都可以与 type 一起出现——包括组合关键字（oneOf、anyOf、allOf、not）、条件关键字（if/then/else）、引用关键字（\$ref、\$defs、\$anchor），以及任何其他标准验证或注释关键字。
当未提供显式 \$schema 时，默认为 JSON Schema 2020-12。
可选的 JSON Schema 对象，定义在 CallToolResult 的 structuredContent 字段中返回的工具输出结构。它可以是任何有效的 JSON Schema 2020-12。
当未提供显式 \$schema 时，默认为 JSON Schema 2020-12。
可选的附加工具信息。
显示名称优先级顺序为：title、annotations.title，然后是 name。
向客户端描述 Tool 的附加属性。
注意：ToolAnnotations 中的所有属性都是提示。它们不保证能忠实描述工具行为（包括 title 这类描述性属性）。
客户端绝不应根据从不受信任服务器收到的 ToolAnnotations 做出工具使用决策。
工具的人类可读标题。
如果为 true，该工具不会修改其环境。
默认值：false
如果为 true，该工具可能对其环境执行破坏性更新。如果为 false，该工具仅执行增量更新。
（仅当 readOnlyHint == false 时，此属性才有意义）
默认值：true
如果为 true，使用相同参数重复调用该工具不会对其环境产生额外影响。
（仅当 readOnlyHint == false 时，此属性才有意义）
默认值：false
如果为 true，此工具可能与外部实体的“开放世界”交互。如果为 false，工具的交互域是封闭的。例如，Web 搜索工具的世界是开放的，而内存工具的世界不是。
默认值：true
表示请求发生错误的响应。