Trait SqliteServerTool 

pub trait SqliteServerTool: JsonSchema {
    type Context;
    type Error: IntoContents;
    type Input: Serialize + for<'de> Deserialize<'de> + JsonSchema + 'static;
    type Output: Serialize + for<'de> Deserialize<'de> + JsonSchema + 'static;

    const NAME: &str;

    // Required method
    fn handle(
        ctx: &Self::Context,
        input: Self::Input,
    ) -> Result<Self::Output, Self::Error>;

    // Provided methods
    fn tool() -> Tool { ... }
    fn handler_func(    ) -> fn(&<Self as SqliteServerTool>::Context, Parameters<<Self as SqliteServerTool>::Input>) -> Result<Json<<Self as SqliteServerTool>::Output>, <Self as SqliteServerTool>::Error> { ... }
}

A statically-typed MCP tool backed by a SQLite server. Each implementor represents a single tool exposed to MCP clients. The trait derives the tool’s JSON schema from its associated types and wires up a handler closure compatible with the rmcp ToolRouter.

Required Associated Constants

const NAME: &str

The tool name advertised to MCP clients (e.g. "execute").

Required Associated Types

type Context

The server type passed to the handler on each invocation, typically McpServerSqlite.

type Error: IntoContents

The error type returned by the handler. Must implement IntoContents so rmcp can render it as error content.

type Input: Serialize + for<'de> Deserialize<'de> + JsonSchema + 'static

The deserialized input parameters received from the MCP client.

type Output: Serialize + for<'de> Deserialize<'de> + JsonSchema + 'static

The structured output returned to the MCP client on success.

Required Methods

fn handle( ctx: &Self::Context, input: Self::Input, ) -> Result<Self::Output, Self::Error>

Executes the tool’s logic against the given context and input. Called synchronously on the tokio blocking thread pool.

Provided Methods

fn tool() -> Tool

Builds the rmcp Tool definition for this tool, including its name, description (extracted from the JsonSchema derive), input schema, and output schema.

fn handler_func() -> fn(&<Self as SqliteServerTool>::Context, Parameters<<Self as SqliteServerTool>::Input>) -> Result<Json<<Self as SqliteServerTool>::Output>, <Self as SqliteServerTool>::Error>

Returns a closure that deserializes the input parameters, calls handle, and wraps the output in Json for structured MCP responses. Every invocation is automatically traced with the tool name, duration, and outcome. The closure is compatible with ToolRouter::with_route.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl SqliteServerTool for BackupTool

const NAME: &str = "backup"

type Context = McpServerSqlite

type Error = ToolError<BackupError>

type Input = BackupInput

type Output = BackupOutput

impl SqliteServerTool for CreateFtsIndexTool

const NAME: &str = "create_fts_index"

type Context = McpServerSqlite

type Error = ToolError<CreateFtsIndexError>

type Input = CreateFtsIndexInput

type Output = CreateFtsIndexOutput

impl SqliteServerTool for DatabaseInfoTool

const NAME: &str = "database_info"

type Context = McpServerSqlite

type Error = ToolError<DatabaseInfoError>

type Input = DatabaseInfoInput

type Output = DatabaseInfoOutput

impl SqliteServerTool for DescribeTableTool

const NAME: &str = "describe_table"

type Context = McpServerSqlite

type Error = ToolError<DescribeTableError>

type Input = DescribeTableInput

type Output = DescribeTableOutput

impl SqliteServerTool for ExecuteTool

const NAME: &str = "execute"

type Context = McpServerSqlite

type Error = ToolError<ExecuteError>

type Input = ExecuteInput

type Output = ExecuteOutput

impl SqliteServerTool for ExplainQueryTool

const NAME: &str = "explain_query"

type Context = McpServerSqlite

type Error = ToolError<ExplainQueryError>

type Input = ExplainQueryInput

type Output = ExplainQueryOutput

impl SqliteServerTool for ListForeignKeysTool

const NAME: &str = "list_foreign_keys"

type Context = McpServerSqlite

type Error = ToolError<ListForeignKeysError>

type Input = ListForeignKeysInput

type Output = ListForeignKeysOutput

impl SqliteServerTool for ListIndexesTool

const NAME: &str = "list_indexes"

type Context = McpServerSqlite

type Error = ToolError<ListIndexesError>

type Input = ListIndexesInput

type Output = ListIndexesOutput

impl SqliteServerTool for ListTablesTool

const NAME: &str = "list_tables"

type Context = McpServerSqlite

type Error = ToolError<ListTablesError>

type Input = ListTablesInput

type Output = ListTablesOutput

impl SqliteServerTool for ListTriggersTool

const NAME: &str = "list_triggers"

type Context = McpServerSqlite

type Error = ToolError<ListTriggersError>

type Input = ListTriggersInput

type Output = ListTriggersOutput

impl SqliteServerTool for ListViewsTool

const NAME: &str = "list_views"

type Context = McpServerSqlite

type Error = ToolError<ListViewsError>

type Input = ListViewsInput

type Output = ListViewsOutput

impl SqliteServerTool for SearchFtsTool

const NAME: &str = "search_fts"

type Context = McpServerSqlite

type Error = ToolError<SearchFtsError>

type Input = SearchFtsInput

type Output = SearchFtsOutput

impl SqliteServerTool for VacuumTool

const NAME: &str = "vacuum"

type Context = McpServerSqlite

type Error = ToolError<VacuumError>

type Input = VacuumInput

type Output = VacuumOutput