Struct McpToolset 

pub struct McpToolset<S = ()>
where
    S: Service<RoleClient> + Send + Sync + 'static,
{ /* private fields */ }

MCP Toolset - connects to an MCP server and exposes its tools as ADK tools.

This toolset implements the ADK Toolset trait and bridges the gap between MCP servers and ADK agents. It:

1. Connects to an MCP server via the provided transport
2. Discovers available tools from the server
3. Converts MCP tools to ADK-compatible Tool implementations
4. Proxies tool execution calls to the MCP server

Example

use adk_tool::McpToolset;
use rmcp::{ServiceExt, transport::TokioChildProcess};
use tokio::process::Command;

// Create MCP client connection to a local server
let client = ().serve(TokioChildProcess::new(
    Command::new("npx")
        .arg("-y")
        .arg("@modelcontextprotocol/server-everything")
)?).await?;

// Create toolset from the client
let toolset = McpToolset::new(client);

// Add to agent
let agent = LlmAgentBuilder::new("assistant")
    .toolset(Arc::new(toolset))
    .build()?;

Implementations

impl<S> McpToolset<S>

where S: Service<RoleClient> + Send + Sync + 'static,

pub fn new(client: RunningService<RoleClient, S>) -> Self

Create a new MCP toolset from a running MCP client service.

The client should already be connected and initialized. Use rmcp::ServiceExt::serve() to create the client.

Example

use rmcp::{ServiceExt, transport::TokioChildProcess};
use tokio::process::Command;

let client = ().serve(TokioChildProcess::new(
    Command::new("my-mcp-server")
)?).await?;

let toolset = McpToolset::new(client);

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

Set a custom name for this toolset.

pub fn with_filter<F>(self, filter: F) -> Self

where F: Fn(&str) -> bool + Send + Sync + 'static,

Add a filter to select which tools to expose.

The filter function receives a tool name and returns true if the tool should be included.

Example

let toolset = McpToolset::new(client)
    .with_filter(|name| {
        matches!(name, "read_file" | "list_directory" | "search_files")
    });

pub fn with_tools(self, tool_names: &[&str]) -> Self

Add a filter that only includes tools with the specified names.

Example

let toolset = McpToolset::new(client)
    .with_tools(&["read_file", "write_file"]);

Trait Implementations

impl<S> Toolset for McpToolset<S>

where S: Service<RoleClient> + Send + Sync + 'static,

fn name(&self) -> &str

fn tools<'life0, 'async_trait>( &'life0 self, _ctx: Arc<dyn ReadonlyContext>, ) -> Pin<Box<dyn Future<Output = Result<Vec<Arc<dyn Tool>>>> + Send + 'async_trait>>

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