Noizu.MCP.JsonRpc (Noizu MCP v0.1.0)

JSON-RPC 2.0 framing for MCP.

Pure data layer: decodes a wire binary into one of four message structs and encodes them back. Per MCP 2025-06-18+ JSON-RPC batching is not supported — arrays are rejected as invalid requests.

Summary

Types

id()

message()

Functions

decode(binary)

Decode a wire binary into a message struct.

encode!(message)

Encode a message struct to wire iodata.

to_map(arg1)

Render a message struct as a plain map (without JSON encoding).

Types

id()

@type id() :: integer() | String.t()

message()

@type message() ::
  Noizu.MCP.JsonRpc.Request.t()
  | Noizu.MCP.JsonRpc.Notification.t()
  | Noizu.MCP.JsonRpc.Response.t()
  | Noizu.MCP.JsonRpc.ErrorResponse.t()

Functions

decode(binary)

@spec decode(binary()) ::
  {:ok, message()} | {:error, Noizu.MCP.JsonRpc.ErrorResponse.t()}

Decode a wire binary into a message struct.

Returns {:error, %ErrorResponse{}} pre-shaped for replying to the sender when the payload is malformed (parse error / invalid request).

encode!(message)

@spec encode!(message()) :: iodata()

Encode a message struct to wire iodata.

to_map(arg1)

@spec to_map(message()) :: map()

Render a message struct as a plain map (without JSON encoding).