Struct ClientIp 

#[non_exhaustive]
pub struct ClientIp {
    pub ip: IpAddr,
}

Resolved client IP of the current request.

Inserted as a request extension on every request served by serve, right after PeerAddr. Equals the direct peer’s IP unless trusted-forwarder mode is active (McpServerConfig::with_trusted_proxies) and the request arrived through a trusted proxy with a verifiable forwarding chain — in that case it is the rightmost-untrusted address from X-Forwarded-For (or RFC 7239 Forwarded, per McpServerConfig::with_forwarded_header).

All built-in per-IP rate limiters key by this value. PeerAddr keeps its direct-socket-peer contract unchanged; applications that need provenance can compare ClientIp.ip with PeerAddr.addr.ip().

Security

Resolution only ever activates when the direct peer is inside the operator’s trusted-proxy CIDRs; every ambiguous chain (malformed or obfuscated entries, all-trusted chains, header bombs) falls back to the direct peer, never to a header value. The framework never logs this value outside rate-limit deny paths.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

ip: IpAddr

Resolved client IP (direct peer unless trusted-forwarder resolution applied).

Trait Implementations

impl Clone for ClientIp

fn clone(&self) -> ClientIp

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ClientIp

impl Debug for ClientIp

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

Formats the value using the given formatter.

impl Eq for ClientIp

impl Hash for ClientIp

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ClientIp

fn eq(&self, other: &ClientIp) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ClientIp