Enum McpError

pub enum McpError {
    Transport(TransportError),
    Protocol(ProtocolError),
    Validation(ValidationError),
    Auth(AuthError),
    Timeout {
        operation: String,
        duration_ms: u64,
    },
    Config(ConfigError),
    Serialization {
        source: Error,
    },
    Io {
        source: Error,
    },
    Internal {
        message: String,
    },
}

The main error type for all MCP operations.

This enum covers all possible error conditions that can occur during MCP client operations, from transport failures to protocol violations.

Examples

use mcp_probe_core::error::{McpError, TransportError};

let error = McpError::Transport(TransportError::ConnectionFailed {
    transport_type: "stdio".to_string(),
    reason: "Process exited unexpectedly".to_string(),
});

println!("Error: {}", error);

Variants

Transport(TransportError)

Transport-related errors (connection, communication, etc.)

Protocol(ProtocolError)

Protocol-level errors (invalid messages, unsupported versions, etc.)

Validation(ValidationError)

Validation errors (schema validation, capability mismatches, etc.)

Auth(AuthError)

Authentication and authorization errors

Timeout

Timeout errors for operations that exceed time limits

Fields

operation: String

The operation that timed out

duration_ms: u64

The timeout duration in milliseconds

Config(ConfigError)

Configuration errors (invalid config files, missing parameters, etc.)

Serialization

Serialization/deserialization errors

Fields

source: Error

The underlying serde_json error

Io

IO errors (file operations, network errors, etc.)

Fields

source: Error

The underlying IO error

Internal

Generic errors for cases not covered by specific variants

Fields

message: String

Error message

Implementations

impl McpError

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

Create a new internal error with a custom message.

This is useful for creating errors from string messages when a more specific error type is not available.

Examples

use mcp_probe_core::error::McpError;

let error = McpError::internal("Something went wrong");

pub fn timeout(operation: impl Into<String>, duration: Duration) -> Self

Create a new timeout error.

Examples

use mcp_probe_core::error::McpError;
use std::time::Duration;

let error = McpError::timeout("server connection", Duration::from_secs(30));

pub fn is_retryable(&self) -> bool

Check if this error is retryable.

Some errors (like network timeouts) may be worth retrying, while others (like invalid credentials) are permanent failures.

Examples

use mcp_probe_core::error::{McpError, TransportError};

let timeout_error = McpError::timeout("connection", std::time::Duration::from_secs(30));
assert!(timeout_error.is_retryable());

let auth_error = McpError::Auth(
    mcp_probe_core::error::AuthError::InvalidCredentials {
        auth_type: "Bearer".to_string(),
        reason: "Invalid token".to_string(),
    }
);
assert!(!auth_error.is_retryable());

pub fn category(&self) -> &'static str

Get the error category for this error.

This is useful for error reporting and metrics collection.

Trait Implementations

impl Debug for McpError

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

Formats the value using the given formatter.

impl Display for McpError

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

Formats the value using the given formatter.

impl Error for McpError

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<AuthError> for McpError

fn from(source: AuthError) -> Self

Converts to this type from the input type.

impl From<ConfigError> for McpError

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<Error> for McpError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for McpError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for McpError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for McpError

fn from(err: ParseError) -> Self

Converts to this type from the input type.

impl From<ProtocolError> for McpError

fn from(source: ProtocolError) -> Self

Converts to this type from the input type.

impl From<TransportError> for McpError

fn from(source: TransportError) -> Self

Converts to this type from the input type.

impl From<ValidationError> for McpError

fn from(source: ValidationError) -> Self

Converts to this type from the input type.