今日 TL;DR
MCP 的三类服务端能力分别承载上下文数据、可调用动作与可复用交互模板。按用途拆接口后,仍要逐次检查权限;发现了能力,不代表已经读取、执行或授权。
- Resources 用 URI 标识可读取内容,适合岗位资料、文档和其他上下文;应用决定如何取用。
- Tools 用名称与参数描述动作,模型可以建议调用,执行授权仍归应用与服务端;工具也可以只读。
- Prompts 提供参数化模板,通常由用户选择使用;取得模板不能自动执行其中提到的工具。
为什么今天学这个
昨天建立了“MCP连接成功不等于业务授权”的边界。本周第二天接着回答接口设计问题:岗位知识库、求职分析模板、创建面试准备单,应该分别怎么暴露?如果把所有能力都做成一个万能工具,模型很难知道哪个只提供背景、哪个会真正改数据,排错也会失去清晰边界。
Resources 是资源,可以理解为“可按地址取得的资料”;Tools 是工具,是“给出参数后执行的一次动作”;Prompts 是提示模板,是“选定一个工作方式后拿到的一组消息”。官方规范常将它们分别描述为应用控制、模型控制、用户控制。这是典型交互设计的区别,不是强制的授权规则,更不代表模型拥有工具最终执行权。Host可以让用户手选工具,也可以在受控流程里主动读取资源,界面设计仍要服务实际任务。
接着上周的可审计Agent项目,本课沿用岗位查证:用户选定岗位后,应用读取岗位Resource,用户选一个分析Prompt,模型如需统计关键词可建议只读Tool。周六跨工具准备台会复用这三类合同。今天不接模型和远程协议,先用可重复的本地函数明确边界;明天把执行进度落到检查点,才能在中断后区分“模板取过了”和“业务动作真的完成了”。
一张图讲清楚
两条输入线最终汇合到上下文,但没有任何一条“模板直接执行”的边。URI只标识资源,不是访问许可证;工具名称只说明调用对象,不证明调用成功。资源内容和Prompt模板都可能包含不可信文本,不能因此扩大工具集合或改变用户身份。图里将授权集中画在工具前,实际读取私有Resource和取得含敏感信息的Prompt时也必须鉴权。
三个核心要点
- 按业务语义选择能力。 静态岗位说明可做Resource;关键词统计可做只读Tool;“按证据分析岗位”的消息结构可做Prompt。Tools不等于写操作,Resources也不等于无敏感信息。发现阶段应给清晰描述、输入合同和返回类型,而不是一个任意SQL或Shell接口。
- 发现、获取和执行分别留证。 协议中的resources/list、resources/read、prompts/list、prompts/get、tools/list、tools/call有不同含义;列表成功只证明能力可发现。得到模板后,Host还要决定是否应用;工具结果也要检查业务状态,不能见到一条自然语言“完成”就结束任务。
- 每类能力都需要最小权限。 从服务端会话取租户,读取Resource时检查归属,调用Tool时检查参数与动作,渲染Prompt时限制输入并保持外部文本的数据身份。工具的只读等注解是提示信息,不能代替服务端授权或作为安全保证。
最小可运行示例
保存为 mcp_capabilities.py,Python 3.10+ 标准库即可,运行 python3 mcp_capabilities.py。输入是本租户岗位URI和模板名;输出是资料、模板与统计结果。这是模拟MCP三类能力的离线业务路由器,不实现JSON-RPC、连接握手、网络认证或真实模型调用。正式连接应采用相应SDK,外层业务授权保留。
from dataclasses import dataclass
@dataclass(frozen=True)
class Session:
tenant: str
DATA = {
"job://tenant-a/role-1": ("tenant-a", "需要 Python 与 RAG 经验"),
"job://tenant-b/role-2": ("tenant-b", "其他客户的岗位"),
}
AUDIT = []
def read_resource(session, uri):
item = DATA.get(uri)
if item is None or item[0] != session.tenant:
raise PermissionError("resource unavailable")
AUDIT.append("resources/read")
return {"uri": uri, "mimeType": "text/plain", "text": item[1]}
def get_prompt(session, name, arguments):
if name != "analyze_job" or set(arguments) != {"uri"}:
raise ValueError("unknown prompt or arguments")
# 只返回模板消息;不读取资源,更不执行消息里提到的动作。
AUDIT.append("prompts/get")
return [{"role": "user", "content": {
"type": "text",
"text": "请分析已授权岗位,证据不足时说明。URI参考:"
+ str(arguments["uri"]),
}}]
def call_tool(session, name, arguments):
if name != "count_terms" or set(arguments) != {"uri"}:
raise ValueError("tool or arguments denied")
resource = read_resource(session, arguments["uri"])
AUDIT.append("tools/call")
return {"counts": {word: resource["text"].count(word)
for word in ("Python", "RAG")}}
if __name__ == "__main__":
session = Session("tenant-a") # 生产由认证中间件建立
uri = "job://tenant-a/role-1"
messages = get_prompt(session, "analyze_job", {"uri": uri})
assert AUDIT == ["prompts/get"]
print("template_only", len(messages))
print(read_resource(session, uri)["text"])
print(call_tool(session, "count_terms", {"uri": uri}))
try:
call_tool(session, "count_terms",
{"uri": "job://tenant-b/role-2"})
except PermissionError as exc:
print(type(exc).__name__, str(exc))
before = list(AUDIT)
get_prompt(session, "analyze_job", {"uri": "delete_everything"})
assert AUDIT == before + ["prompts/get"]
print("untrusted_reference_did_not_execute")
预期依次输出template_only 1、岗位原文、Python与RAG各1次的counts、PermissionError resource unavailable,以及untrusted_reference_did_not_execute。最后一个值故意不是合法URI:模板只把它放到数据位置,没有执行器;如果后续真正读取它,read_resource会拒绝。生产模板应额外校验URI形状、长度和允许的协议,不要把这个教学行为当作完整输入验证。
这个实现没有list接口,也没有根据模型输出自动分派Tools。目的是证明三类动作在审计记录中可区分。read_resource成功只能证明读取了本租户资料;count_terms是确定性字符统计,不证明候选人与岗位匹配,更不预测面试结果。对资源实际访问仍需数据库级授权与最小字段投影,不能只在Host用字符串前缀隔离租户。
生产环境会怎么翻车
- 模板一取就创建工单。 症状:用户只预览Prompt却产生写入。根因:模板加载器混入执行器。处理:prompts/get只返回消息,真正工具调用经过独立授权、参数摘要与必要确认,执行回执另记。
- URI猜对便读到别人的岗位。 症状:跨租户数据出现在上下文中。根因:只验证地址格式,未验证对象归属。处理:从可信会话注入身份,在资源服务逐次鉴权,对不存在和无权访问避免泄漏对象存在性。
- 只读注解被当成安全证明。 症状:一个标注readOnly的工具仍修改外部数据。根因:信任服务器的描述超过实际执行合同。处理:审查实现、限制凭据作用域、隔离写接口并用业务日志检查;未知服务器的注解按不可信提示处理。
- 模板或文档改变系统指令。 症状:资料里出现“导出所有客户”,模型照做。根因:外部内容被提升为指令。处理:保持内容来源、限制工具白名单、服务端拒绝越权,记录异常并回归,不依赖一句“忽略恶意文本”。
动手练习
用20分钟增加一个 resources/list 的本地替身,仅返回本租户URI,并增加 list_prompts 返回模板名和参数说明。完成条件:正常读取、跨租户拒绝、未知工具拒绝、模板不执行四项都有断言;审计能分开列出发现、获取、执行。再写一段解释:为什么count_terms虽然只读仍是Tool?因为它提供参数化计算动作;不是所有只读能力都必须做Resource。不要引入真实发信或删除接口来演示。
面试表达
30 秒回答
Resources按URI提供上下文,Tools暴露可调用动作,Prompts返回可复用消息模板。典型控制方分别是应用、模型建议和用户选择,但授权始终由应用与服务端检查。我会分开发现、读取、模板获取和工具执行的审计;模板与资料都是外部内容,不能让它们自动授予权限。
追问与 3 分钟回答
如果问“搜索是Resource还是Tool”,我会先看接口语义:按一个稳定URI取已知岗位详情适合Resource;根据查询词执行搜索并返回命中结果适合Tool。Tool可以只读,Resource也可由动态后端产生。选择依据是交互、参数、结果和可发现性,而不是把静态与动态机械地一分为二。
如果问“Prompt中提到删除工具怎么办”,我会解释取得模板与执行动作之间没有必然关系。Host可以展示模板,用户决定应用,模型可能建议工具,但调用前必须检查当前用户权限、目标对象和动作范围。对外发信或其他副作用另走确认与幂等。拒绝后应返回明确状态,不能为了满足模板而换更强权限重试。
作品集会展示三类接口、服务端授权点和四个失败输入。记录可以帮助排错,但只保存必要字段;资料和提示里的隐私不能无限写进日志。明天的检查点还要保存模板版本与资源版本,否则恢复时可能拿旧批准执行新内容。
今日自测
1. 基础理解
取得一个Prompt模板,是否表示里面提到的Tools已经调用?
不是。prompts/get返回消息模板;调用工具是单独的动作,需要授权、执行与结果记录。
2. 工程取舍
关键词统计只读,为什么可以设计成Tool?
它接收参数执行计算并返回结果,符合Tool语义。只读并不等于Resource;Resource更适合按URI提供上下文。
3. 场景应用
远程工具标注readOnlyHint=true,可以跳过权限检查吗?
不可以。注解是提示,尤其来自未知服务器时不应当成安全事实;仍要验证凭据、对象、实现及实际副作用。
市场雷达
本期无新增市场信号。今日读取官方协议说明以核验能力与安全边界,未将文档访问日期当成最近30天的规范发布日期,也未编造JD或招聘数字。
权威来源
- MCP Resources规范 — URI、资源读取和应用控制的典型交互。
- MCP Tools规范 — 工具发现、调用与安全考虑;工具描述/注解不替代信任与授权。
- MCP Prompts规范 — 参数化消息模板及用户控制的典型交互。
上述三个官方页面于2026-10-27 09:02(Asia/Shanghai)实际访问HTTP 200。本课固定引用2025-06-18版本说明基本语义,不声称它是当前最新版;生产需与实际Server协商版本。示例是本课编写并离线验证的业务骨架,不是官方SDK示例。
明天会用到
明天学习检查点和断点续跑:保存已完成动作、资源与模板版本、待执行请求及真实回执,中断后先核实副作用,再决定从哪条边继续。今天区分的三类记录,是恢复时判断事实的基础。