turbomcp-protocol 3.1.5

Complete MCP protocol implementation with types, traits, context management, and message handling
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

//! Filesystem boundaries types for the current MCP protocol.
//!
//! This module contains types for filesystem boundary discovery,
//! allowing servers to understand client filesystem access boundaries.

use serde::{Deserialize, Serialize};

use super::core::Uri;

/// Filesystem root definition
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    /// Root URI (typically a file:// URI)
    pub uri: Uri,
    /// Optional human-readable name for this root
    #[serde(skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    /// Optional metadata per the current MCP specification
    #[serde(rename = "_meta", skip_serializing_if = "Option::is_none")]
    pub _meta: Option<serde_json::Value>,
}

/// List roots request with optional metadata
/// Note: Roots do not support pagination, only metadata
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct ListRootsRequest {
    /// Optional metadata per the current MCP specification
    #[serde(rename = "_meta", skip_serializing_if = "Option::is_none")]
    pub _meta: Option<serde_json::Value>,
}

/// List roots result
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ListRootsResult {
    /// Available filesystem roots
    pub roots: Vec<Root>,
    /// Optional metadata per the current MCP specification
    #[serde(skip_serializing_if = "Option::is_none")]
    pub _meta: Option<serde_json::Value>,
}

/// Roots list changed notification (no parameters)
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RootsListChangedNotification {}