Enum ScanError 

pub enum ScanError {
    Io(Error),
    DirectoryNotFound {
        path: String,
    },
    MissingMetadata {
        path: String,
    },
    MetadataParse {
        path: String,
        source: Error,
    },
    UnsupportedSchema {
        found: u32,
        expected: u32,
    },
    TooManyFiles {
        count: usize,
        limit: usize,
    },
    FileTooLarge {
        path: String,
        size: u64,
        limit: u64,
    },
    StaleMetadata {
        tool: String,
        expected_file: String,
        sidecar_path: String,
    },
}

Errors that can occur while scanning a server directory for its _meta.json sidecar.

Variants

Io(Error)

I/O error reading the directory or sidecar file.

DirectoryNotFound

Directory does not exist.

Fields

path: String

Sanitized path of the missing directory.

MissingMetadata

The _meta.json sidecar is missing from the server directory.

Fields

path: String

Sanitized path of the expected sidecar file.

MetadataParse

The _meta.json sidecar could not be parsed as valid ServerMetadata JSON.

Fields

path: String

Sanitized path of the sidecar file that failed to parse.

source: Error

Underlying JSON deserialization error.

UnsupportedSchema

The sidecar’s schema_version does not match the version this crate understands.

Fields

found: u32

Schema version read from the sidecar.

expected: u32

Schema version this crate supports (METADATA_SCHEMA_VERSION).

TooManyFiles

Too many tools in the sidecar (denial-of-service protection).

Fields

count: usize

Number of tools listed in the sidecar.

limit: usize

Maximum allowed number of tools (MAX_TOOL_FILES).

FileTooLarge

Sidecar file too large to process.

Fields

path: String

Sanitized path of the oversized sidecar file.

size: u64

Actual size of the file, in bytes.

limit: u64

Maximum allowed size, in bytes (MAX_FILE_SIZE).

StaleMetadata

A tool listed in the _meta.json sidecar has no corresponding .ts file on disk.

This indicates the sidecar and the generated TypeScript files have drifted apart — e.g. the file was deleted manually, or a generate run was interrupted before writing it.

Fields

tool: String

MCP tool name listed in the sidecar.

expected_file: String

.ts file name expected on disk for tool.

sidecar_path: String

Sanitized path of the sidecar that references tool.

Trait Implementations

impl Debug for ScanError

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

Formats the value using the given formatter.

impl Display for ScanError

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

Formats the value using the given formatter.

impl Error for ScanError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for ScanError

fn from(source: Error) -> Self

Converts to this type from the input type.