Struct ComponentVisibilityRules 

pub struct ComponentVisibilityRules {
    pub allow: Option<BTreeSet<String>>,
    pub deny: BTreeSet<String>,
    pub hide: BTreeSet<String>,
}

Progressive disclosure through component visibility control. Exact-name visibility rules for one MCP component family.

Matching is case-sensitive and exact. Deny rules win over allow rules. When allow is Some, only matching identifiers are enabled; when it is None, every identifier is enabled unless it appears in deny. Hidden identifiers remain callable/readable/gettable, but are omitted from list_* responses.

Resources and resource templates are matched by both name and URI/URI template, so config authors can use whichever identifier is most stable for their server.

Fields

allow: Option<BTreeSet<String>>

Exact identifiers to enable. None means no allowlist is configured.

An empty set inside Some intentionally disables the entire component family.

deny: BTreeSet<String>

Exact identifiers to disable from both listing and direct use.

hide: BTreeSet<String>

Exact identifiers to omit from lists while still permitting direct use.

Implementations

impl ComponentVisibilityRules

pub fn new() -> Self

Create rules that enable and list everything unless denied or hidden.

pub fn allow<I, S>(names: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Create rules that enable only the given exact identifiers.

pub fn deny<I, S>(names: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Create rules that disable the given exact identifiers.

pub fn hide<I, S>(names: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Create rules that omit the given exact identifiers from lists.

pub fn with_allowed<I, S>(self, names: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Replace the allowlist with the given exact identifiers.

pub fn with_disabled<I, S>(self, names: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Replace the denylist with the given exact identifiers.

pub fn with_hidden<I, S>(self, names: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Replace the hidden list with the given exact identifiers.

pub fn is_enabled(&self, identifier: &str) -> bool

Check whether a single exact identifier is enabled for direct use.

pub fn is_enabled_any<'a, I>(&self, identifiers: I) -> bool

where I: IntoIterator<Item = &'a str>,

Check whether any identifier for the same component is enabled for direct use.

Denying any identifier disables the component. When an allowlist is present, at least one identifier must be allowlisted.

pub fn is_listed(&self, identifier: &str) -> bool

Check whether a single exact identifier should appear in list responses.

pub fn is_listed_any<'a, I>(&self, identifiers: I) -> bool

where I: IntoIterator<Item = &'a str>,

Check whether any identifier for the same component should appear in lists.

Trait Implementations

impl Clone for ComponentVisibilityRules

fn clone(&self) -> ComponentVisibilityRules

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ComponentVisibilityRules

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

Formats the value using the given formatter.

impl Default for ComponentVisibilityRules

fn default() -> ComponentVisibilityRules

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ComponentVisibilityRules

where ComponentVisibilityRules: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ComponentVisibilityRules

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

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 ComponentVisibilityRules

impl StructuralPartialEq for ComponentVisibilityRules