Struct McpTestHarness 

pub struct McpTestHarness { /* private fields */ }

Test harness for MCP server operations

Implementations

impl McpTestHarness

pub fn new() -> Self

Create a new test harness with a fresh database

Panics

Panics if the database cannot be creationDate or the server cannot be initialized

pub fn new_with_config(middleware_config: MiddlewareConfig) -> Self

Create a new test harness with a fresh database and custom middleware config

Panics

Panics if the database cannot be creationDate or the server cannot be initialized

pub fn with_middleware_config(middleware_config: MiddlewareConfig) -> Self

Create a test harness with custom middleware configuration

Panics

Panics if the database cannot be creationDate or the server cannot be initialized

pub fn server(&self) -> &ThingsMcpServer

Get a reference to the MCP server

pub fn db_path(&self) -> &Path

Get the database path for additional testing

pub async fn call_tool( &self, name: &str, arguments: Option<Value>, ) -> CallToolResult

Call a tool and return the result

Panics

Panics if the tool call fails

pub async fn call_tool_with_fallback( &self, name: &str, arguments: Option<Value>, ) -> CallToolResult

Call a tool with fallback error handling

pub async fn read_resource(&self, uri: &str) -> ReadResourceResult

Read a resource and return the result

Panics

Panics if the resource read fails

pub async fn read_resource_result( &self, uri: &str, ) -> Result<ReadResourceResult, McpError>

Read a resource and return the result or error

Errors

Returns an error if the resource cannot be read or if the MCP server is not available.

pub async fn read_resource_with_fallback(&self, uri: &str) -> ReadResourceResult

Read a resource with fallback error handling

pub async fn get_prompt( &self, name: &str, arguments: Option<Value>, ) -> GetPromptResult

Get a prompt

Panics

Panics if the prompt request fails

pub async fn get_prompt_result( &self, name: &str, arguments: Option<Value>, ) -> Result<GetPromptResult, McpError>

Get a prompt and return the result or error

Errors

Returns an error if the prompt cannot be retrieved or if the MCP server is not available.

pub async fn get_prompt_with_fallback( &self, name: &str, arguments: Option<Value>, ) -> GetPromptResult

Get a prompt with fallback error handling

pub async fn assert_tool_succeeds( &self, name: &str, arguments: Option<Value>, ) -> CallToolResult

Assert that a tool call succeeds

Panics

Panics if the tool call fails

pub async fn assert_tool_fails_with<F>( &self, name: &str, arguments: Option<Value>, _expected_error: F, )

where F: FnOnce(&McpError) -> bool,

Assert that a tool call fails with expected error

Panics

Panics if the tool call succeeds when it should fail

pub async fn assert_resource_succeeds(&self, uri: &str) -> ReadResourceResult

Assert that a resource read succeeds

Panics

Panics if the resource read fails

pub async fn assert_resource_fails_with<F>(&self, uri: &str, expected_error: F)

where F: FnOnce(&McpError) -> bool,

Assert that a resource read fails with expected error

Panics

Panics if the resource read succeeds when it should fail

pub async fn assert_prompt_succeeds( &self, name: &str, arguments: Option<Value>, ) -> GetPromptResult

Assert that a prompt succeeds

Panics

Panics if the prompt request fails

pub async fn assert_prompt_fails_with<F>( &self, name: &str, arguments: Option<Value>, expected_error: F, )

where F: FnOnce(&McpError) -> bool,

Assert that a prompt fails with expected error

Panics

Panics if the prompt request succeeds when it should fail

pub async fn assert_tool_returns_json( &self, name: &str, arguments: Option<Value>, ) -> Value

Assert that a tool call returns valid JSON

Panics

Panics if the tool call fails or returns invalid JSON

pub async fn assert_resource_returns_json(&self, uri: &str) -> Value

Assert that a resource read returns valid JSON

Panics

Panics if the resource read fails or returns invalid JSON

pub async fn assert_prompt_returns_text( &self, name: &str, arguments: Option<Value>, ) -> String

Assert that a prompt returns valid text

Panics

Panics if the prompt request fails or returns no text content

Trait Implementations

impl Default for McpTestHarness

fn default() -> Self

Returns the “default value” for a type.