bevy_brp_mcp 0.22.2

MCP server for Bevy Remote Protocol (BRP) integration
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

//! `registry.schema` tool - Get type schemas

use bevy_brp_mcp_macros::ParamStruct;
use bevy_brp_mcp_macros::ResultStruct;
use schemars::JsonSchema;
use serde::Deserialize;
use serde::Serialize;
use serde_json::Value;

use crate::brp_tools::Port;

/// Parameters for the `registry.schema` tool
#[derive(Clone, Deserialize, Serialize, JsonSchema, ParamStruct)]
pub struct RegistrySchemaParams {
    /// Include only types from these crates (e.g., [`bevy_transform`, `my_game`])
    #[serde(skip_serializing_if = "Option::is_none")]
    pub with_crates: Option<Vec<String>>,

    /// Include only types with these reflect traits (e.g., [`Component`, `Resource`])
    #[serde(skip_serializing_if = "Option::is_none")]
    pub with_types: Option<Vec<String>>,

    /// Exclude types from these crates (e.g., [`bevy_render`, `bevy_pbr`])
    #[serde(skip_serializing_if = "Option::is_none")]
    pub without_crates: Option<Vec<String>>,

    /// Exclude types with these reflect traits (e.g., `RenderResource`)
    #[serde(skip_serializing_if = "Option::is_none")]
    pub without_types: Option<Vec<String>>,

    /// The BRP port (default: 15702)
    #[serde(default)]
    pub port: Port,
}

/// Result for the `registry.schema` tool
#[derive(Serialize, ResultStruct)]
#[brp_result]
pub struct RegistrySchemaResult {
    /// The raw BRP response - array of type schemas
    #[serde(skip_serializing_if = "Option::is_none")]
    #[to_result(skip_if_none)]
    pub result: Option<Value>,

    /// Count of types returned
    #[to_metadata(result_operation = "count")]
    pub type_count: usize,

    /// Message template for formatting responses
    #[to_message(message_template = "Retrieved {type_count} schemas")]
    pub message_template: String,
}