fastmcp-rust 0.3.1

Fast, cancel-correct MCP framework for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

//! Test harness infrastructure for FastMCP.
//!
//! This module provides utilities for writing comprehensive tests without mocks:
//!
//! - [`TestContext`]: Wrapper around `Cx::for_testing()` with helper methods
//! - [`TestServer`]: Builder for creating test servers with real handlers
//! - [`TestClient`]: Client for in-process testing with MemoryTransport
//! - Assertion helpers for validating JSON-RPC and MCP compliance
//! - Timing utilities for performance measurements
//! - [`fixtures`]: Test data generators for tools, resources, prompts, and messages
//!
//! # Example
//!
//! ```ignore
//! use fastmcp_rust::testing::prelude::*;
//!
//! #[test]
//! fn test_tool_call() {
//!     let ctx = TestContext::new();
//!
//!     // Create a test server with real handlers
//!     let (router, client_transport, server_transport) = TestServer::builder()
//!         .build();
//!
//!     // Create a test client
//!     let mut client = TestClient::new(client_transport);
//!     client.initialize().unwrap();
//!
//!     // Call tool and verify
//!     let result = client.call_tool("my_tool", json!({"arg": "value"}));
//!     assert!(result.is_ok());
//! }
//! ```
//!
//! # Design Philosophy
//!
//! - **No mocks**: All tests use real implementations via MemoryTransport
//! - **Deterministic**: Uses asupersync Lab runtime for reproducibility
//! - **Comprehensive logging**: Built-in trace support for debugging
//! - **Resource cleanup**: Automatic cleanup of spawned tasks

mod assertions;
mod client;
mod context;
pub mod fixtures;
mod server;
mod timing;
mod trace;

pub use assertions::*;
pub use client::*;
pub use context::*;
pub use server::*;
pub use timing::*;
pub use trace::*;

/// Prelude for convenient imports in tests.
///
/// ```ignore
/// use fastmcp_rust::testing::prelude::*;
/// ```
pub mod prelude {
    pub use super::{
        // Timing
        Stopwatch,
        // Client
        TestClient,
        // Context
        TestContext,
        // Server
        TestServer,
        TestServerBuilder,
        // Trace
        TestTrace,
        TestTraceBuilder,
        TestTraceOutput,
        Timer,
        TimingStats,
        TraceEntry,
        TraceLevel,
        TraceSummary,
        // Assertions
        assert_content_valid,
        assert_is_notification,
        assert_is_request,
        assert_json_rpc_error,
        assert_json_rpc_success,
        assert_json_rpc_valid,
        assert_mcp_compliant,
        assert_prompt_valid,
        assert_resource_valid,
        assert_tool_valid,
        is_trace_enabled,
        measure_duration,
    };

    // Re-export commonly used types
    pub use crate::{
        Content, Cx, JsonRpcMessage, JsonRpcRequest, JsonRpcResponse, McpContext, McpError,
        McpErrorCode, McpResult, Prompt, Resource, Tool,
    };

    pub use serde_json::json;
}