Struct JsonRpcRequest

pub struct JsonRpcRequest {
    pub jsonrpc: String,
    pub id: RequestId,
    pub method: String,
    pub params: Option<Value>,
}

JSON-RPC 2.0 request message.

Represents a request from client to server that expects a response. All MCP operations (except notifications) use this message type.

Fields

jsonrpc: String

JSON-RPC version (always “2.0”)

id: RequestId

Unique identifier for request/response correlation

method: String

Method name being invoked

params: Option<Value>

Parameters for the method (can be object or array)

Implementations

impl JsonRpcRequest

pub fn new( id: impl Into<RequestId>, method: impl Into<String>, params: Value, ) -> Self

Create a new JSON-RPC request with the given ID, method, and parameters.

Examples

use mcp_probe_core::messages::core::JsonRpcRequest;
use serde_json::json;

let request = JsonRpcRequest::new(
    "1".to_string(),
    "initialize".to_string(),
    json!({"protocolVersion": "2024-11-05"}),
);

pub fn without_params( id: impl Into<RequestId>, method: impl Into<String>, ) -> Self

Create a new JSON-RPC request without parameters.

Examples

use mcp_probe_core::messages::core::JsonRpcRequest;

let request = JsonRpcRequest::without_params("1", "tools/list");

pub fn with_random_id(method: impl Into<String>, params: Value) -> Self

Generate a new request with a random UUID as the ID.

This is useful when you don’t need to track specific request IDs.

pub fn has_params(&self) -> bool

Check if this request has parameters.

pub fn params_as<T>(&self) -> Result<T, Error>

where T: for<'de> Deserialize<'de>,

Get the parameters as a specific type.

Examples

use mcp_probe_core::messages::core::JsonRpcRequest;
use serde_json::json;
use serde::{Deserialize, Serialize};

#[derive(Deserialize, Serialize)]
struct InitParams {
    #[serde(rename = "protocolVersion")]
    protocol_version: String,
}

let request = JsonRpcRequest::new(
    "1",
    "initialize",
    json!({"protocolVersion": "2024-11-05"})
);

let params: InitParams = request.params_as().unwrap();
assert_eq!(params.protocol_version, "2024-11-05");

Trait Implementations

impl Clone for JsonRpcRequest

fn clone(&self) -> JsonRpcRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JsonRpcRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JsonRpcRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<JsonRpcRequest> for JsonRpcMessage

fn from(req: JsonRpcRequest) -> Self

Converts to this type from the input type.

impl PartialEq for JsonRpcRequest

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for JsonRpcRequest

impl StructuralPartialEq for JsonRpcRequest