ARTICLE · 1360526
MCP资源机制:把企业文档喂给Agent
TOPIC:S3-1
企业想让 Agent 真干活,第一道坎不是模型不够聪明,而是它读不到企业里的东西:产品手册在网盘、报价单在表格、工单记录在系统里。MCP 的 Resources 机制就是为这一步准备的——今天讲清原理,再给一段能跑的 Server 代码。
先分清两个词:Tools 是"动作",让 Agent 能执行操作;Resources 是"资料",把文档以只读的方式挂出来。大白话:Tools 是给 Agent 发工牌,Resources 是给它开一个只许看、不许拿的资料柜。
原理:uri 定位,list 发现,read 读取
每个资源有一个固定格式的地址(uri),比如 doc://product/manual。客户端先调 resources/list 拿到目录,再把选中资源的 uri 传给 resources/read 拿内容。注意一个关键设计:资源是 Agent 主动按需拉的,不是 Server 一股脑塞给它——上下文窗口就那么大,目录先行、按需取内容,Token 才花在刀刃上。

代码:20 行把文档挂上去
from mcp.server.fastmcp import FastMCP mcp = FastMCP("company-docs") @mcp.resource("doc://product/manual") def product_manual() -> str: """产品手册(只读快照)""" return open("/data/manual.md", encoding="utf-8").read() @mcp.resource("doc://sales/price-list") def price_list() -> str: return open("/data/price.csv", encoding="utf-8").read() if __name__ == "__main__": mcp.run(transport="stdio")
客户端侧两步:列目录、按 uri 读取。把读到的内容拼进系统提示或对话上下文,Agent 回答"报价是多少"时就有了唯一可信的出处。
为什么这一步值得企业现在就做
给几个可验证的行业坐标:中国 AI Agent 市场规模 2026 年预计 449 亿元,到 2029 年预计达 3320 亿元;同时有 88% 的智能体部署发生过生产事故、约 40% 的试点预计在 2027 年前被废弃。差的那些项目,多数不是输在模型,而是输在数据接不进、权限管不住。Resources 这层把文档留在内网、只放只读快照、每次读取留日志,正是把"试点"变成"生产"的第一道闸门。
踩坑点
- 大文件直接裸读:一本 200 页手册塞进上下文,一次对话烧掉一大笔 Token。先切分、给每个资源配摘要,正文按需再读。
- 资源里混敏感字段:报价单里的成本列、客户手机号必须先脱敏再挂载,Server 是最后一道闸。
- 版本不管理:手册更新了快照没更,Agent 拿旧报价承诺客户。给资源加更新时间戳,读取时校验新鲜度。
行动建议:从企业里挑一份最常被员工翻的文档,今晚就照上面 20 行代码挂成资源,让 Agent 回答一次真实问题,验证这层薄薄的接口值不值。
0基础想学AI,就关注极客AI社群JKAI2e,专业部署企业级AI智能体Agent、GEO、OPC项目合作、陪跑,AI智能体矩阵获客、AI智能体双域生态闭环、全网横纵矩阵链路搭建,自媒体短视频矩阵、公众号矩阵、站群矩阵、AI员工智能体矩阵、定向精准推广获客JKAI2e。
关于本号
极客AI殿堂|技术号·极客沉淀
讲原理,能复现。
主号推荐 · 极客AI聚合社
极客AI聚合社|主号·品牌枢纽
讲清楚、有温度,社群入口。
极客AI聚合社群 · 5 个号怎么选
| 公众号 | 角色 | 适合看什么 |
|---|---|---|
| 极客AI聚合社 | 主号·品牌枢纽 | 讲清楚、有温度,社群入口 |
| 极客AI聚合 | 工具号·低门槛 | 看完就能上手 |
| AI极客殿堂 | 资讯号·高频活跃 | 快而可信,帮你筛信息 |
| 极客AI殿堂 (本号) | 技术号·极客沉淀 | 讲原理,能复现 |
| 聚合AI员工JH-Agent | 实战号·转化促活 | 有结果,可照抄 |
话题:
#极客AI社群 #聚合AI员工Agent #人工智能体 #AI员工 #AI #Workbuddy #DeepSeek #kimi #GLM #Qwen #MiniMax #Baichuan #Yi #AIagent #AIGC #FED #OPC #GEO #LLM #Prompt #Context #MCP #Skill #Agent #Harness #Token #RAG















































































