Struct Root 

pub struct Root {
    pub uri: String,
    pub name: Option<String>,
    pub meta: Option<HashMap<String, Value>>,
}

👎Deprecated since 0.4.0:

Deprecated per SEP-2577 (2026-07-28). Replacement: pass directories or files via tool parameters, resource URIs, or server configuration. Earliest removal: first release on/after 2027-07-28.

Root directory entry.

Deprecated per SEP-2577 — see module-level docs.

Fields

uri: String

👎Deprecated since 0.4.0:

Deprecated per SEP-2577 (2026-07-28). Replacement: pass directories or files via tool parameters, resource URIs, or server configuration. Earliest removal: first release on/after 2027-07-28.

URI of the root (must start with “file://” currently)

name: Option<String>

👎Deprecated since 0.4.0:

Deprecated per SEP-2577 (2026-07-28). Replacement: pass directories or files via tool parameters, resource URIs, or server configuration. Earliest removal: first release on/after 2027-07-28.

Optional human-readable name

meta: Option<HashMap<String, Value>>

👎Deprecated since 0.4.0:

Deprecated per SEP-2577 (2026-07-28). Replacement: pass directories or files via tool parameters, resource URIs, or server configuration. Earliest removal: first release on/after 2027-07-28.

Optional metadata

Implementations

impl Root

pub fn new(uri: impl Into<String>) -> Root

pub fn with_name(self, name: impl Into<String>) -> Root

pub fn with_meta(self, meta: HashMap<String, Value>) -> Root

pub fn validate(&self) -> Result<(), String>

Validate that the URI follows MCP requirements

Trait Implementations

impl Clone for Root

fn clone(&self) -> Root

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Root

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Root

fn deserialize<__D>( __deserializer: __D, ) -> Result<Root, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl HasRootAnnotations for Root

fn annotations(&self) -> Option<&HashMap<String, Value>>

Get custom metadata

fn tags(&self) -> Option<&[String]>

Get root-specific tags or labels

impl HasRootFiltering for Root

fn allowed_extensions(&self) -> Option<&[String]>

File extensions to include (None = all)

fn excluded_patterns(&self) -> Option<&[String]>

File patterns to exclude (glob patterns)

fn should_include(&self, path: &str) -> bool

Check if a file should be included

impl HasRootMetadata for Root

fn name(&self) -> Option<&str>

Optional human-readable name

fn uri(&self) -> &str

The root URI (must start with “file://”)

fn description(&self) -> Option<&str>

Optional description or additional metadata

impl HasRootPermissions for Root

fn can_read(&self, _path: &str) -> bool

Check if read access is allowed for this path

fn can_write(&self, _path: &str) -> bool

Check if write access is allowed for this path

fn max_depth(&self) -> Option<usize>

Get maximum depth for directory traversal

impl Serialize for Root

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.