1. 先弄明白:MCP 里的资源到底是个什么东西
1.1 从一次真实卡壳说起
我最初接触 MCP 资源这个概念时,脑子里全是问号。当时我在 Claude Code 里配好了一个内部的 GitLab MCP Server,原本预期是让 Claude 直接读取仓库里的某个配置文件,结果它反复告诉我“没有权限访问外部 URL”。我一开始以为是鉴权没配好,折腾半天才发现,问题出在我对这个 MCP Server 暴露的能力模型理解错了——它只暴露了 tools(工具),根本就没暴露 resources(资源)。
这个卡壳经历其实是大多数人的共同起点。Claude Code 里的 MCP 一共提供了三类核心原语:Tools(工具)、Resources(资源) 和 Prompts(提示词模板)。绝大部分教程都在讲 Tools,因为工具最直观——“让 Claude 能执行动作”;但 Resources 同样关键,它解决的是另一个问题:让 Claude 能读取上下文。简单说,工具是手,资源是眼睛。没有资源,Claude 在很多时候就是睁眼瞎,只能靠对话里你手动粘贴的内容来干活。
这篇教程就是想把 Resources 这块讲透。不管是静态文件、数据库查询结果、API 返回的 JSON,还是某个动态生成的报告,只要你想让 Claude 在对话过程中“按需拿到外部信息”,资源就是标准答案。适合正在折腾 Claude Code MCP 配置的开发者、把 Claude 接入内部系统的运维/平台工程师,以及想给团队搭一套统一知识接入层的人。
1.2 资源、工具、提示词,三者的分工
在继续往下之前,先建立一个清晰的心智模型。MCP 的三大原语,分别对应模型交互中的三种不同需求:
| 原语 | 类比 | 典型用途 | 谁主动发起 |
|---|---|---|---|
| Tools | 手 | 执行操作:查天气、创建工单、写文件、调 API | 模型自主决定调用 |
| Resources | 眼睛 | 提供上下文:读配置文件、拉取文档、查询数据快照 | 模型按需读取,也可由用户显式指引 |
| Prompts | 剧本 | 预置指令模板:让模型按固定套路处理某类任务 | 用户主动触发 |
注意 Tools 和 Resources 的一个关键区别:工具是有副作用的动作,资源是纯读取的信息。MCP 协议在设计上故意分开,就是为了让客户端可以做精细化权限管理——你想让模型能“看”某些敏感数据,但未必希望它能“改”这些数据。
1.3 为什么说资源是 MCP 里被低估的一块
社区里讨论 MCP 时,90% 的帖子在讲 Server 怎么写、Tool 怎么调,Resources 经常被一笔带过。但我实际用下来,资源才是最贴合日常开发场景的部分。举个例子:你让 Claude 帮忙改一个 Spring Boot 项目的配置,它如果不先读一遍 application.yml,全靠猜,改出来的东西大概率是错的;如果能把配置作为资源暴露给它,它第一步就会去读取,之后所有建议都建立在真实上下文上。
另一个高频场景是团队知识库接入。把内部规范文档、接口定义、历史决策记录通过 MCP Resource 暴露出去,Claude 在对话中就能按需查阅,不用每次把文档内容复制进 prompt。这个用法对上下文窗口的节省非常可观——不是所有内容都要塞进对话,而是等模型需要时再去取。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心概念:Resource URI 与 Resource Template
2.1 一切资源都是 URI
MCP 协议里,资源用 URI 来标识。这里的 URI 不只是 http:// 那种,它可以是任何自定义 scheme。比如:
code复制file:///Users/me/projects/foo/config.yaml
git://repo/commit/abc123/docs/README.md
db://users/42/profile
doc://internal/onboarding-guide
之所以采用 URI 而不是普通字符串 ID,是因为 URI 自带结构和语义,客户端可以对 URI 做解析、校验和层级管理。比如你可以通过 URI 的路径部分判断资源所属的项目或分类,便于做权限控制。
在 Claude Code 中,你不需要直接手写 URI 去请求资源,但理解 URI 结构有助于你排查问题。比如当某个资源读取失败时,错误信息里通常带着
