释放数据潜力：利用 MCP 资源让大模型读懂你的服务器
点击下方“JavaEdge”，选择“设为星标”
第一时间关注技术干货！
免责声明~
任何文章不要过度深思！
万事万物都经不起审视，因为世上没有同样的成长环境，也没有同样的认知水平，更「没有适用于所有人的解决方案」；
不要急着评判文章列出的观点，只需代入其中，适度审视一番自己即可，能「跳脱出来从外人的角度看看现在的自己处在什么样的阶段」才不为俗人。
怎么想、怎么做，全在乎自己「不断实践中寻找适合自己的大道」
0 前言
★向LLM暴露服务器上的数据和内容
”
资源（Resources）是MCP核心概念，允许服务器将数据和内容暴露，供客户端读取，并作为大模型交互的上下文使用。
注意
资源是由应用控制的，即客户端应用可自行决定资源的使用方式和时机。不同 MCP 客户端可能不同方式处理资源，如：
Claude Desktop 要求用户手动选择资源后才能用
其他客户端可能会基于启发式方法自动选择资源
有些实现甚至允许 AI 模型自行决定使用哪些资源。
因此，服务器开发者在实现资源支持时，应考虑各种交互方式。如希望自动将数据暴露给模型，应使用由模型控制的工具。
1 概述
资源可代表 MCP 服务器希望提供给客户端的任何类型的数据，包括但不限于：
文件内容
数据库记录
API 响应
实时系统数据
截图和图像
日志文件
其他各种数据
每个资源都有一个唯一 URI 标识，内容可以是文本或二进制数据。
2 URI
资源通过 URI 唯一标识，格式如下：
[protocol]://[host]/[path]示例：
file:///home/user/documents/report.pdfpostgres://database/customers/schemascreen://localhost/display1
URI 的协议和路径结构由 MCP 服务器自行定义，服务器可定制自己的 URI 方案。
3 类型
资源内容可分为两种类型：
3.1 文本
包含 UTF-8 编码的文本数据，适合以下内容：
源代码
配置文件
日志文件
JSON/XML 数据
纯文本
3.2 二进制
包含使用 base64 编码的原始二进制数据，适合以下内容：
图像
PDF
音频文件
视频文件
其他非文本格式
4 发现方式
客户端可通过两种方式发现可用资源：
4.1 直接资源列表
服务器通过 resources/list 接口提供明确的资源清单，每个资源包含以下信息：
{
uri: string; // 资源唯一标识
name: string; // 可读名称
description?: string; // 可选描述信息
mimeType?: string; // 可选 MIME 类型
}4.2 资源模板
对于动态资源，服务器可暴露 URI 模板，客户端可根据模板生成合法的资源 URI：
{
uriTemplate: string; // 遵循 RFC 6570 的 URI 模板
name: string; // 可读名称
description?: string; // 可选描述
mimeType?: string; // 可选 MIME 类型
}5 读取资源内容
客户端使用资源 URI 通过 resources/read 请求读取资源，服务器返回资源内容列表：
{
contents: [
{
uri: string; // 资源 URI
mimeType?: string; // 可选 MIME 类型
// 二选一：
text?: string; // 文本内容
blob?: string; // 二进制内容（base64 编码）
}
]
}服务器可在一次 resources/read 请求中返回多个资源，如读取目录时可返回其中的所有文件。
6 更新
MCP 支持实时资源更新，主要有两种机制：
6.1 列表变更
当服务器的资源列表发生变化时，通过 notifications/resources/list_changed 通知客户端。
6.2 内容变更
客户端可以订阅某个资源的变更：
客户端发送
resources/subscribe请求并附带资源 URI；服务器在资源内容变更时，发送
notifications/resources/updated通知；客户端通过
resources/read获取最新内容；客户端可以发送
resources/unsubscribe取消订阅。
7 示例
简单的 MCP 服务器实现资源支持的例子：
// 提供资源列表
server.setRequestHandler(ListResourcesRequestSchema, async () => {
return {
resources: [
{
uri: "file:///logs/app.log",
name: "应用日志",
mimeType: "text/plain"
}
]
};
});
// 读取资源内容
server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
const uri = request.params.uri;
if (uri === "file:///logs/app.log") {
const logContents = await readLogFile();
return {
contents: [
{
uri,
mimeType: "text/plain",
text: logContents
}
]
};
}
throw new Error("未找到资源");
});@app.list_resources()
async def list_resources() -> list[types.Resource]:
return [
types.Resource(
uri="file:///logs/app.log",
name="应用日志",
mimeType="text/plain"
)
]
@app.read_resource()
async def read_resource(uri: AnyUrl) -> str:
if str(uri) == "file:///logs/app.log":
log_contents = await read_log_file()
return log_contents
raise ValueError("未找到资源")
# 启动服务器
async with stdio_server() as streams:
await app.run(
streams[0],
streams[1],
app.create_initialization_options()
)8 最佳实践
实现资源支持时，建议：
使用清晰、具描述性的资源名称和 URI；
添加有用的描述，帮助大模型理解资源；
在已知的情况下设置合适的 MIME 类型；
为动态内容实现资源模板；
对频繁变更的资源使用订阅机制；
出错时返回清晰明了的错误信息；
对资源列表进行分页处理（如有必要）；
在适当情况下缓存资源内容；
处理资源前先验证 URI；
文档中注明自定义的 URI 方案。
9 安全
在暴露资源时，请注意以下安全措施：
验证所有资源 URI 的合法性；
实施适当的访问控制策略；
清理文件路径，防止目录遍历攻击；
谨慎处理二进制数据；
对资源读取设置速率限制；
审计资源访问记录；
传输过程中加密敏感数据；
验证 MIME 类型是否符合预期；
为耗时较长的读取操作设置超时机制；
适时清理过期或无效资源。
本文已收录在Github Java-Interview-Tutorial，关注我，紧跟本系列专栏文章，咱们下篇再续！
🚀 魔都架构师 | 全网30W技术追随者
🔧 大厂分布式系统/数据中台实战专家
🏆 主导交易系统亿级流量调优 & 车联网平台架构
🧠 AIGC应用开发先行者 | 区块链落地实践者
🌍 以技术驱动创新，我们的征途是改变世界！
👉 实战干货：编程严选网
关注我，紧跟本系列专栏文章，咱们下篇再续！
加我好友，一起AI探索交流：
写在最后
编程严选网：
http://www.javaedge.cn/专注分享AI时代下软件开发全场景最新最佳实践，点击文末【阅读原文】即可直达~
