Struct McpToolbox

pub struct McpToolbox { /* private fields */ }

Available on crate feature mcp only.

Connects to an MCP server and provides tools at runtime to the agent.

WARN: The rmcp has a quirky feature to serve from (). This does not work; serve from ClientInfo instead, or from the transport and Swiftide will handle the rest.

Implementations

impl McpToolbox

pub fn with_blacklist<ITEM: Into<String>, I: IntoIterator<Item = ITEM>>( &mut self, blacklist: I, ) -> &mut Self

Blacklist tools by name, the agent will not be able to use these tools

pub fn with_whitelist<ITEM: Into<String>, I: IntoIterator<Item = ITEM>>( &mut self, blacklist: I, ) -> &mut Self

Whitelist tools by name, the agent will only be able to use these tools

pub fn with_filter(&mut self, filter: ToolFilter) -> &mut Self

Apply a custom filter to the tools

pub fn with_name(&mut self, name: impl Into<String>) -> &mut Self

Apply an optional name to the toolbox

pub fn name(&self) -> &str

pub async fn try_from_transport<E: Error + From<Error> + Send + Sync + 'static, A>( transport: impl IntoTransport<RoleClient, E, A>, ) -> Result<Self>

Create a new toolbox from a transport

Errors

Errors if the transport fails to connect

pub fn from_running_service( service: RunningService<RoleClient, InitializeRequestParam>, ) -> Self

Create a new toolbox from a running service

pub async fn cancel(&mut self) -> Result<()>

Disconnects from the MCP server if it is running

If it is not running, an Ok is returned and it logs a tracing message

Errors

Errors if the service is running but cannot be stopped

Trait Implementations

impl Clone for McpToolbox

fn clone(&self) -> McpToolbox

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ToolBox for McpToolbox

fn available_tools<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<Box<dyn Tool>>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn name(&self) -> Cow<'_, str>

fn boxed<'a>(self) -> Box<dyn ToolBox + 'a>

where Self: Sized + 'a,