Enum Error

pub enum Error {
    Protocol {
        code: ErrorCode,
        message: String,
        data: Option<Value>,
    },
    Transport(TransportError),
    Serialization(Error),
    Validation(String),
    Authentication(String),
    Timeout(u64),
    UnsupportedCapability(String),
    Internal(String),
    NotFound(String),
    InvalidState(String),
    Cancelled,
    Other(Error),
}

Main error type for MCP operations.

Variants

Protocol

JSON-RPC protocol errors

Fields

code: ErrorCode

Error code as defined in JSON-RPC spec

message: String

Human-readable error message

data: Option<Value>

Optional additional error data

Transport(TransportError)

Transport-level errors

Serialization(Error)

Serialization/deserialization errors

Validation(String)

Validation errors

Authentication(String)

Authentication errors

Timeout(u64)

Timeout errors

UnsupportedCapability(String)

Capability errors

Internal(String)

Internal errors

NotFound(String)

Resource not found

InvalidState(String)

Invalid state

Cancelled

Cancelled operation

Other(Error)

Other errors

Implementations

impl Error

pub fn protocol(code: ErrorCode, message: impl Into<String>) -> Self

Create a protocol error with the given code and message.

pub fn protocol_msg(message: impl Into<String>) -> Self

Create a protocol error with just a message (defaults to InternalError code).

pub fn protocol_with_data( code: ErrorCode, message: impl Into<String>, data: Value, ) -> Self

Create a protocol error with additional data.

pub fn validation(message: impl Into<String>) -> Self

Create a validation error.

pub fn internal(message: impl Into<String>) -> Self

Create an internal error.

pub fn not_found(resource: impl Into<String>) -> Self

Create a not found error.

pub fn parse(message: impl Into<String>) -> Self

Create a parse error.

pub fn invalid_request(message: impl Into<String>) -> Self

Create an invalid request error.

pub fn method_not_found(method: impl Into<String>) -> Self

Create a method not found error.

pub fn invalid_params(message: impl Into<String>) -> Self

Create an invalid params error.

pub fn authentication(message: impl Into<String>) -> Self

Create an authentication error.

pub fn capability(message: impl Into<String>) -> Self

Create a capability error.

pub fn resource_not_found(uri: impl Into<String>) -> Self

Create a resource not found error.

pub fn from_jsonrpc_error(error: JSONRPCError) -> Self

Create from JSON-RPC error.

pub fn is_error_code(&self, code: ErrorCode) -> bool

Check if this is a protocol error with a specific code.

pub fn error_code(&self) -> Option<ErrorCode>

Get the error code if this is a protocol error.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for JSONRPCError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<TransportError> for Error

fn from(source: TransportError) -> Self

Converts to this type from the input type.