rmcp-openapi 0.29.0

Library for converting OpenAPI specifications to MCP tools
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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

use rmcp_actix_web::transport::AuthorizationHeader;
use std::str::FromStr;

/// Authorization handling for MCP server operations
///
/// This enum combines the authorization mode with the actual header value,
/// ensuring type safety and a cleaner API.
#[derive(Debug, Clone, Default)]
pub enum Authorization {
    /// No authorization header will be forwarded (MCP-compliant)
    #[default]
    None,

    /// Forward authorization with debug logging (requires feature flag)
    #[cfg(feature = "authorization-token-passthrough")]
    PassthroughWarn(Option<AuthorizationHeader>),

    /// Forward authorization silently (requires feature flag)
    #[cfg(feature = "authorization-token-passthrough")]
    PassthroughSilent(Option<AuthorizationHeader>),
}

/// Simple mode enum for conversion (matches CLI AuthorizationMode)
#[derive(Debug, Clone, Copy, Default)]
pub enum AuthorizationMode {
    #[default]
    Compliant,
    #[cfg(feature = "authorization-token-passthrough")]
    PassthroughWarn,
    #[cfg(feature = "authorization-token-passthrough")]
    PassthroughSilent,
}

impl FromStr for AuthorizationMode {
    type Err = String;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s {
            "compliant" => Ok(AuthorizationMode::Compliant),
            #[cfg(feature = "authorization-token-passthrough")]
            "passthrough-warn" => Ok(AuthorizationMode::PassthroughWarn),
            #[cfg(feature = "authorization-token-passthrough")]
            "passthrough-silent" => Ok(AuthorizationMode::PassthroughSilent),
            _ => {
                #[cfg(feature = "authorization-token-passthrough")]
                let valid = "compliant, passthrough-warn, passthrough-silent";
                #[cfg(not(feature = "authorization-token-passthrough"))]
                let valid = "compliant";
                Err(format!(
                    "Invalid authorization mode: '{}'. Valid values: {}",
                    s, valid
                ))
            }
        }
    }
}

impl Authorization {
    /// Create Authorization from a mode and optional header
    pub fn from_mode(
        mode: AuthorizationMode,
        #[cfg_attr(
            not(feature = "authorization-token-passthrough"),
            allow(unused_variables)
        )]
        header: Option<AuthorizationHeader>,
    ) -> Self {
        match mode {
            AuthorizationMode::Compliant => Authorization::None,
            #[cfg(feature = "authorization-token-passthrough")]
            AuthorizationMode::PassthroughWarn => Authorization::PassthroughWarn(header),
            #[cfg(feature = "authorization-token-passthrough")]
            AuthorizationMode::PassthroughSilent => Authorization::PassthroughSilent(header),
        }
    }
}