根目录（Roots）是 MCP 中定义服务器可操作边界的一个概念。它为客户端提供了一种方式来告知服务器相关资源及其位置。

​
什么是根目录？

根目录是客户端建议服务器关注的 URI。当客户端连接到服务器时，它会声明服务器应该使用哪些根目录。虽然主要用于文件系统路径，但根目录可以是任何有效的 URI，包括 HTTP URL。

For example, roots could be:

file:///home/user/projects/myapp
https://api.example.com/v1

​
为什么使用根目录？

根目录有几个重要用途：

  1. 指导性：它们告知服务器相关资源和位置
  2. 清晰性：根目录明确指出哪些资源是工作区的一部分
  3. 组织性：多个根目录让你能够同时处理不同的资源

​
根目录如何工作

当客户端支持根目录时，它会：

  1. 在连接时声明 roots 能力
  2. 向服务器提供建议的根目录列表
  3. 在根目录变化时通知服务器（如果支持）

虽然根目录是信息性的而非严格强制的，但服务器应该：

  1. 尊重提供的根目录
  2. 使用根目录 URI 来定位和访问资源
  3. 优先处理根目录边界内的操作

​
常见用例

根目录通常用于定义：

  • 项目目录
  • 仓库位置
  • API 端点
  • 配置位置
  • 资源边界

​
最佳实践

在使用根目录时：

  1. 只建议必要的资源
  2. 为根目录使用清晰、描述性的名称
  3. 监控根目录的可访问性
  4. 优雅地处理根目录变化

​
示例

这是一个典型的 MCP 客户端如何暴露根目录：

{
  "roots": [
    {
      "uri": "file:///home/user/projects/frontend",
      "name": "Frontend Repository"
    },
    {
      "uri": "https://api.example.com/v1",
      "name": "API Endpoint"
    }
  ]
}

这个配置建议服务器同时关注本地仓库和 API 端点，同时保持它们在逻辑上的分离。

采样传输