Struct McpDispatcher 

pub struct McpDispatcher { /* private fields */ }

Transport-agnostic MCP dispatcher used by the v0.10.2 HTTP /mcp route. Holds the per-tenant SoloMcpServer needed to answer tools/list and tools/call.

The dispatcher itself is stateless beyond the held server — callers build a fresh dispatcher per request (cheap; the server is Arc-cloneable) and discard it after dispatch returns.

Implementations

impl McpDispatcher

pub fn new( registry: Arc<TenantRegistry>, tenant: Arc<TenantHandle>, user_aliases: Vec<String>, audit_principal: Option<String>, ) -> Self

Build a dispatcher for one tenant. The caller is expected to resolve the tenant (via X-Solo-Tenant header for HTTP, or via --tenant flag for stdio) and pass an Arc<TenantHandle> here.

audit_principal is the subject that authored every tool call dispatched through this server — typically "bearer" for bearer-authenticated HTTP requests, the SOLO_MCP_PRINCIPAL_TOKEN env-var value for stdio, or None for unauthenticated loopback.

pub fn from_server(server: SoloMcpServer) -> Self

Wrap an already-built SoloMcpServer. Used by tests that want to pin the underlying server’s principal exactly; production callers should prefer Self::new.

pub async fn dispatch( &self, request: JsonRpcRequest, session: Option<Arc<SessionState>>, ) -> Option<JsonRpcResponse>

Dispatch one JSON-RPC request and return the wire response.

Returns None when the input is a notification (no id field) — per JSON-RPC 2.0 the server MUST NOT respond to notifications. The HTTP transport translates None into a 204 No Content or empty 200, depending on the client; the stdio path doesn’t use this method (rmcp handles framing for stdio).

v0.11.0 P3: session is the Arc<SessionState> planted on /mcp requests by the session middleware (Some on HTTP transport, None on stdio). When the request is a tools/call carrying _meta.progressToken AND session is Some, the handler builds a ProgressReporter and threads it into SoloMcpServer::dispatch_tool. Other request types ignore the session argument entirely.

Trait Implementations

impl Clone for McpDispatcher

fn clone(&self) -> McpDispatcher

Returns a duplicate of the value.

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

Performs copy-assignment from source.