MCP Academy · 课时

根目录能告诉服务器什么

了解客户端开放了哪些文件夹。

第 1 / 4 课13 个步骤

根目录能告诉服务器什么 是 CoddyKit 上的免费 MCP Academy 课时。 这是第 1 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 MCP Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 MCP Academy 课程共包含 4 节课。

服务器有些“盲目”

您的服务器作为独立进程运行,因此无法直接看到用户的项目。它需要客户端告诉它哪些文件夹可以访问。这个提示称为根目录。🧭

根目录究竟是什么

根目录是客户端指定服务器可以在其中工作的单个位置,通常是一个项目文件夹。它标记了您应该访问的边界。

根目录通常是 file:// URI

大多数根目录都是指向磁盘上某个目录的 file:// URI。这种方案明确表示您访问的是本地文件夹,而不是网址。

file:///home/ada/projects/my-app

还可以有一个友好名称

每个根目录都可以带有可选的名称,例如“My App”这样的简短标签。它只面向人员使用,因此日志和提示中会显示清晰的名称,而不是原始路径。

多个根目录

客户端可以同时公开多个根目录,例如一个代码文件夹和一个文档文件夹。您的服务器应将这个列表视为它可以触及的完整位置集合。

根目录是建议,不是牢笼

根目录是指导信息,而不是协议强制执行的硬性边界。它告诉您应重点关注哪里,但实际留在这些范围内则是您的责任。✋

为什么这能保护用户

根目录允许用户表达“在这里工作,其他地方不要碰”。这种范围限制可以防止服务器误入用户实际打开的项目之外很远的私密文件。

客户端拥有根目录列表

客户端决定哪些位置算作根目录,通常来自用户打开的工作区文件夹。服务器不会设置自己的根目录,只会读取客户端提供的内容。

根目录可以变化

根目录并不是固定不变的。如果用户打开了新文件夹,这个集合就会发生变化,而具备相应能力的客户端可以告知服务器列表已经更新。

并非所有客户端都有根目录

根目录是客户端的可选功能。有些宿主会提供,有些不会,因此构建良好的服务器无论列表非空还是为空,都能妥善工作。

根目录在 JSON 中的样子

在传输过程中,根目录条目非常简单:只有一个 URI 和一个可选名称。服务器只需知道这些内容,就能确定自己可以在哪里操作。

{ "uri": "file:///home/ada/projects/my-app", "name": "My App" }

快速检查

请确认您已经理解根目录的用途。

总结:根目录简述

您了解到,根目录是客户端提供的位置,通常是一个带可选名称的 file:// 文件夹,用于限定服务器应在哪些位置工作。列表由客户端拥有,也可以发生变化。🎯

免费开始

用 AI 导师学习 Python — 免费

在浏览器中编写并运行真实代码,获得全天候 AI 导师的即时帮助,并在网页或应用中继续学习。

课程
30
课程
120

常见问题解答

「根目录能告诉服务器什么」课时是免费的吗?

是的 — 「根目录能告诉服务器什么」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 MCP Academy 课程的其余内容,请升级到 CoddyKit PRO。 MCP Academy 课程共包含 4 节课。

「根目录能告诉服务器什么」这节课中我会学到什么?

了解客户端开放了哪些文件夹。 你通过在浏览器中直接运行的动手代码来练习 MCP Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 MCP Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 MCP Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 1 节课,共 4 节。

「根目录能告诉服务器什么」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 MCP Academy 课中编写并运行代码吗?

能。每节 MCP Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 根目录能告诉服务器什么
  2. 请求客户端的根目录
  3. 协商能力
  4. 遵守客户端边界
← 返回 MCP Academy