Struct PeerAddr 

#[non_exhaustive]
pub struct PeerAddr {
    pub addr: SocketAddr,
}

Direct socket peer address of the current HTTP/TLS connection.

Inserted as a request extension into every request served by serve — on both the plain and the TLS listener — and extractable in any axum handler, including routes mounted via McpServerConfig::with_extra_router (which bypass auth/RBAC and therefore often need the peer address for their own protection, e.g. per-IP rate limiting).

The same address is also mirrored into axum::extract::ConnectInfo<SocketAddr> on the TLS listener, so third-party middleware that expects the stock axum extension (e.g. per-IP rate-limit key extractors) works unmodified under TLS.

Semantics

• Direct peer only. This is the socket’s remote address. Behind an L4/L7 proxy or load balancer it is the proxy’s address; the framework performs no X-Forwarded-For / Forwarded interpretation.
• Available on HTTP and TLS transports alike (serve).
• Absent under serve_stdio — a stdio session has no network peer (stdio bypasses the HTTP stack entirely).
• The separate Prometheus metrics listener (feature metrics) is a different router and does not carry this extension.

Privacy

PeerAddr exposes raw peer network metadata. The framework deliberately never logs it on its own; whether to log or persist peer addresses is application policy.

Example

use axum::{Router, routing::get};
use rmcp_server_kit::transport::{McpServerConfig, PeerAddr};

async fn whoami(peer: PeerAddr) -> String {
    peer.addr.ip().to_string()
}

let _config = McpServerConfig::new("127.0.0.1:8443", "my-server", "1.0.0")
    .with_extra_router(Router::new().route("/whoami", get(whoami)));

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.

addr: SocketAddr

Direct socket peer of this connection.

Trait Implementations

impl Clone for PeerAddr

fn clone(&self) -> PeerAddr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PeerAddr

impl Debug for PeerAddr

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

Formats the value using the given formatter.

impl Eq for PeerAddr

impl<S: Send + Sync> FromRequestParts<S> for PeerAddr

Extract PeerAddr from request extensions.

Rejection

Responds 500 Internal Server Error when the extension is missing. A missing PeerAddr means the handler is not running under serve (e.g. the router was mounted on a hand-rolled listener) — a wiring bug, not a client error.

type Rejection = (StatusCode, &'static str)

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request_parts( parts: &mut Parts, _state: &S, ) -> Result<Self, Self::Rejection>

Perform the extraction.

impl Hash for PeerAddr

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 PeerAddr

fn eq(&self, other: &PeerAddr) -> 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 PeerAddr