Struct Root 

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

Represents a root directory or file that the server can operate on.

Roots allow clients to expose filesystem roots to servers, enabling:

• Scoped file access
• Workspace awareness
• Security boundaries

Example

use tower_mcp_types::protocol::Root;

let root = Root::new("file:///home/user/project");
assert_eq!(root.uri, "file:///home/user/project");
assert!(root.name.is_none());

let root = Root::with_name("file:///workspace", "My Project");
assert_eq!(root.name.unwrap(), "My Project");

Fields

uri: String

The URI identifying the root. Must start with file:// for now.

name: Option<String>

Optional human-readable name for the root

meta: Option<Value>

Optional protocol-level metadata

Implementations

impl Root

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

Create a new root with just a URI

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

Create a new root with a URI and name

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 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.