附录 A.1 术语表:按主题归类的中英对照
文档摘要
附录 A.1 术语表:按主题归类的中英对照 本节摘要:本节是全书术语的检索入口,按五大主题归类,给中英对照与一句话含义,供你在任何章节卡壳时快速回忆。这份表与第各章的「术语首次出现给英文」呼应——遇到陌生术语,先来这里查含义与首次出现章节,再回查正文。本表会随 MCP 协议演进而扩充。 一、协议与角色 中文 | English | 一句话含义 | 首次出现 模型上下文协议 | MCP, Model Context Protocol | 让 LLM 标准化连接外部工具与数据源的协议,基于 JSON-RPC | 教程总纲 宿主 | Host | LLM 应用本身(Claude Desktop、IDE、Agent 运行时),用户对话的对象 | 第 2.
附录 A.1 术语表:按主题归类的中英对照
本节摘要:本节是全书术语的检索入口,按五大主题归类,给中英对照与一句话含义,供你在任何章节卡壳时快速回忆。这份表与第各章的「术语首次出现给英文」呼应——遇到陌生术语,先来这里查含义与首次出现章节,再回查正文。本表会随 MCP 协议演进而扩充。
一、协议与角色
| 中文 | English | 一句话含义 | 首次出现 |
|---|---|---|---|
| 模型上下文协议 | MCP, Model Context Protocol | 让 LLM 标准化连接外部工具与数据源的协议,基于 JSON-RPC | 教程总纲 |
| 宿主 | Host | LLM 应用本身(Claude Desktop、IDE、Agent 运行时),用户对话的对象 | 第 2.1 节 |
| 客户端 | Client | 宿主内部说 MCP 的那一半,一个宿主对每个服务端跑一个 | 第 2.1 节 |
| 服务端 | Server | 你用本 SDK 构建的东西,暴露能力,从不直接对话模型 | 第 2.1 节 |
| JSON-RPC | JSON-RPC | MCP 消息的线缆格式,基于 JSON 的远程过程调用协议 | 第 2.4 节 |
| 协议版本 | Protocol Version | MCP 规范修订号,如 2026-07-28(现代)或更早(legacy) | 第 9.2 节 |
| 协议版本协商 | Version Negotiation | 客户端与服务端选共同支持的最高版本 | 第 9.2 节 |
二、三大原语
| 中文 | English | 一句话含义 | 首次出现 |
|---|---|---|---|
| 工具 | Tool | 模型控制的原语,类比 POST,有副作用,模型决定调用 | 第 2.2 节 |
| 资源 | Resource | 应用控制的原语,类比 GET,只读数据,宿主决定加载 | 第 2.2 节 |
| 资源模板 | Resource Template | 带参数 URI 的资源,需提供参数实例化才能读 | 第 5.1 节 |
| 具体资源 | Concrete Resource | 无参数 URI 的资源,固定数据,可直接列举 | 第 5.1 节 |
| 提示词 | Prompt | 用户控制的原语,命名消息模板,用户主动触发 | 第 2.2 节 |
| 补全 | Completion | 为资源模板/提示词参数提供自动建议的能力 | 第 5.4 节 |
三、能力、契约与输出
| 中文 | English | 一句话含义 | 首次出现 |
|---|---|---|---|
| 能力声明 | Capability Declaration | 服务端告诉客户端「我支持哪些能力族」的清单 | 第 3.3 节 |
| 注册即声明 | Register-then-Declare | 注册处理器即自动声明对应能力,不注册就不声明 | 第 3.3 节 |
| 列表变更通知 | list_changed | 列表内容变化时发的通知(加了/减了哪个工具) | 第 3.3 节 |
| 函数元数据 | func_metadata | SDK 扫描函数提取元数据的引擎 | 第 4.1 节 |
| 类型即契约 | Types as Contract | 类型注解就是工具契约,SDK 据此生成 Schema | 第 4.1 节 |
| 结构化输出 | Structured Output | 工具返回的类型化数据,以返回类型注解为输出 Schema | 第 4.2 节 |
| 工具注解 | ToolAnnotations | 声明工具行为特征(只读、破坏性、幂等、开放)的元信息 | 第 4.3 节 |
四、上下文、依赖与交互
| 中文 | English | 一句话含义 | 首次出现 |
|---|---|---|---|
| 上下文 | Context | 请求级对象,按类型注解注入,提供读资源/报进度等 | 第 6.1 节 |
| 依赖解析 | Resolve | 用解析函数在工具执行前填充参数的机制,对模型不可见 | 第 6.2 节 |
| 生命周期上下文 | Lifespan Context | 服务端启动时建立的共享资源(连接池等) | 第 6.4 节 |
| 引导填写 | Elicitation | 工具执行中途向用户反问以获取输入的能力 | 第 7.1 节 |
| 多轮往返 | MRTR, Multi-Round-Trip Request | 请求返回问题、客户端带答案重试的机制 | 第 7.3 节 |
| 采样 | Sampling | 工具反过来请客户端做 LLM 补全(已弃用趋势) | 第 7.4 节 |
| 根 | Roots | 客户端告知服务端工作区文件夹(已弃用趋势) | 第 7.4 节 |
| 进度上报 | Progress Reporting | 工具执行中告知客户端完成度的单向通知 | 第 7.5 节 |
五、传输、客户端与扩展
| 中文 | English | 一句话含义 | 首次出现 |
|---|---|---|---|
| 传输 | Transport | 承载 MCP 消息的底层机制,产出读写流 | 第 8.1 节 |
| stdio 传输 | stdio Transport | 子进程传输,标准输入输出当线缆,本地默认 | 第 8.2 节 |
| 流式 HTTP | Streamable HTTP | 生产级 HTTP 传输,2025-03-26 主力,取代 SSE | 第 8.3 节 |
| 服务器发送事件 | SSE, Server-Sent Events | 旧版 HTTP 传输,已被流式 HTTP 取代 | 第 8.4 节 |
| 内存传输 | In-Memory Transport | 进程内直连,无 JSON-RPC 帧,测试用 | 第 8.5 节 |
| 传输安全 | Transport Security | DNS 重绑定防护等网络层安全机制 | 第 8.5 节 |
| 第一类 Client | First-class Client | v2 的客户端高层封装,按参数类型自动选传输 | 第 9.1 节 |
| 客户端会话 | ClientSession | 客户端低层会话,Client 的内部基础 | 第 9.4 节 |
| 会话组 | ClientSessionGroup | 客户端聚合多个服务端的抽象 | 第 10.2 节 |
| 响应缓存 | Response Caching | 用 CacheHint/CacheMode 复用响应,避免重复调用 | 第 10.3 节 |
| 订阅 | Subscription | 客户端订阅资源变化,变化时收通知 | 第 10.4 节 |
| OAuth 2.1 | OAuth 2.1 | MCP 用的授权框架,定义四角色 | 第 11.1 节 |
| 授权服务器 | Authorization Server | 签发令牌的 OAuth 角色(MCP 服务端承担) | 第 11.1 节 |
| 资源服务器 | Resource Server | 校验令牌保护资源的 OAuth 角色(MCP 服务端承担) | 第 11.1 节 |
| 客户端凭证 | Client Credentials | 机器到机器的 OAuth 流,无用户参与 | 第 11.4 节 |
| 身份断言 | Identity Assertion | 把外部 IdP 身份带进 MCP,避免重复登录 | 第 11.4 节 |
| 低层 Server | Low-level Server | 裸协议对象处理器,MCPServer 的地基 | 第 12.1 节 |
| 两层模型 | Two-layer Model | MCPServer 构建于低层 Server 之上的分层 | 第 2.3 节 |
| 扩展 | Extension | 定义 MCP 未覆盖的自定义方法 | 第 12.3 节 |
| 方法绑定 | MethodBinding | 把自定义方法绑定到扩展的装饰器 | 第 12.3 节 |
| 中间件 | Middleware | 拦截请求流水线的可叠加处理层 | 第 12.4 节 |
| Apps | Apps | 从服务端提供 UI 页面 | 第 12.5 节 |
| 可观测性 | Observability | 追踪/指标/日志三件套,OpenTelemetry 集成 | 第 12.5 节 |
本节要点回顾
- 五大主题:协议与角色、三大原语、能力契约输出、上下文依赖交互、传输客户端扩展。
- 每个术语给中英对照与一句话含义,标注首次出现章节,便于回查正文。
- 本表会随 MCP 演进扩充,新版本术语持续补充。
- 遇到陌生术语先查本表,再按首次出现章节回查正文详解。
- 术语全书统一,与各章「首次出现给英文」一致。
术语表清楚了,下一节是 API 与命令速查表。
评论区
(0)
U