AI Agent / 知识点

MCP 开发速查手册

手册条目

快速判断 MCP Host、Client 和 Server 在一次连接中的职责边界。

区分 MCP Host、Client 与 Server

判断职责时先看“谁面向用户、谁维护协议连接、谁提供能力”。Host 负责整体体验与安全控制;Client 是 Host 内部连接某个 Server 的协议组件;Server 只暴露工具、资源、提示词等能力,不负责决定模型如何使用它们。

职责边界

角色 主要职责 不应承担
Host 管理用户会话、模型、权限、同意流程与多个 Client;汇总各 Server 的能力 不把未授权数据自动发送给 Server
Client 对接一个 Server,处理传输、JSON-RPC、版本与能力发现、请求路由和错误返回 不独立决定业务权限或替用户批准高风险操作
Server 提供 Tools、Resources、Prompts 等能力,并校验输入、执行业务逻辑、返回结果 不假设自己能直接访问 Host 的模型、其他 Server 或全部用户上下文

MCP Host、Client 与 Server 的连接关系

快速判断

遇到“是否允许调用删除工具、是否把文件内容交给模型”时,责任在 Host,因为它掌握用户意图、会话和授权界面。Server 仍需做最小权限、参数校验和服务端鉴权,但不能把自身校验当作用户同意。

遇到“如何连接 stdio 或 Streamable HTTP、如何发送请求、如何处理协议版本不兼容”时,责任在 Client 或所用 SDK。Host 可以配置策略,但不应把协议细节散落到业务页面中。

遇到“查询数据库、读取仓库、调用内部 API、返回结构化结果”时,责任在 Server。Server 应把能力声明和实际权限保持一致,不能在工具描述中承诺自己无法保证的行为。

高频连接形态

本地工具通常是 Host 启动本地 Server,并通过 stdio 创建一个 Client。远程服务通常由多个 Host 的 Client 通过 Streamable HTTP 访问同一个 Server 实例或集群。

一个 Host 连接多个 Server 时,应为每个 Server 建立独立 Client,并分别记录能力、认证信息、超时和健康状态。这样单个 Server 故障不会污染其他连接,也能准确定位工具来自哪个服务。

风险与边界

把 Server 当成 Host 会导致服务端自行决定模型调用、用户授权或上下文传播,后果是越权操作和数据泄露。安全替代方案是由 Host 统一展示来源、参数和确认动作,Server 只执行已授权请求。

让多个不相关 Server 共用同一份可变 Client 状态,会造成能力串线、凭据误用和错误路由。安全替代方案是按 Server 隔离 Client、认证与缓存,并在日志中同时记录 Host 会话 ID、Client 标识和 Server 标识。

速查结论:Host 管全局与授权,Client 管一条协议连接,Server 管能力实现。

目录与阅读设置

记录一个想法

MCP 开发速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通