orionis.mcp.protocol.codecs

THE ORIONIS API

Build with clarity.

Explore the building blocks of an async-first Python framework. Every module, class, and method — connected, searchable, and ready to build with.

Explore modules View classes

module documentation

(source)

Undocumented

Function	`decode_envelope`	Parse a single UTF-8 JSON-RPC message without decoding its payload.
Function	`decode_params`	Validate method-specific parameters and per-request metadata.
Function	`encode_error`	Serialize only explicitly public exception fields.
Constant	`_ENVELOPE`	Undocumented
Constant	`METHOD_DECODERS`	Undocumented

def decode_envelope(data: bytes) -> JsonRpcRequest: (source) ¶

Parse a single UTF-8 JSON-RPC message without decoding its payload.

Parameters
data:`bytes`	Value supplied for `data`.

Returns
`JsonRpcRequest`	Result of the operation described above.

def decode_params(request: JsonRpcRequest) -> RequestParams: (source) ¶

Validate method-specific parameters and per-request metadata.

Parameters
request:`JsonRpcRequest`	Current request and its trusted execution context.

Returns
`RequestParams`	Result of the operation described above.

def encode_error(exception: McpProtocolException, request_id: str | int | msgspec.UnsetType = msgspec.UNSET) -> bytes: (source) ¶

Serialize only explicitly public exception fields.

Parameters
exception:`McpProtocolException`	Exception being inspected or reported.
request_id:`str \| int \| msgspec.UnsetType`	Value supplied for `request_id`.

Returns
`bytes`	Result of the operation described above.

_ENVELOPE = (source) ¶

Undocumented

Value

msgspec.json.Decoder(JsonRpcRequest)

METHOD_DECODERS = (source) ¶

Undocumented

Value

MappingProxyType({'server/discover': msgspec.json.Decoder(RequestParams),
                  'tools/list': msgspec.json.Decoder(PaginatedParams),
                  'tools/call': msgspec.json.Decoder(CallToolParams),
                  'resources/list': msgspec.json.Decoder(PaginatedParams),
                  'resources/templates/list': msgspec.json.Decoder(PaginatedParams↵
),
                  'resources/read': msgspec.json.Decoder(ReadResourceParams),
...