Struct TestMcpToolContext 

pub struct TestMcpToolContext {
    pub auth: AuthContext,
    pub request: RequestMetadata,
    /* private fields */
}

Test context for MCP tool functions.

Provides an isolated testing environment for MCP tools with configurable authentication, mock HTTP, and mock job/workflow dispatch.

Example

let ctx = TestMcpToolContext::builder()
    .as_user(Uuid::new_v4())
    .with_role("admin")
    .build();

// Dispatch a job
ctx.dispatch_job("process_event", payload).await?;

// Verify job was dispatched
ctx.job_dispatch().assert_dispatched("process_event");

Fields

auth: AuthContext

Authentication context.

request: RequestMetadata

Request metadata.

Implementations

impl TestMcpToolContext

pub fn builder() -> TestMcpToolContextBuilder

Create a new builder.

pub fn minimal() -> TestMcpToolContext

Create a minimal unauthenticated context (no database).

pub fn authenticated(user_id: Uuid) -> TestMcpToolContext

Create an authenticated context with the given user ID (no database).

pub fn db(&self) -> Option<&Pool<Postgres>>

Get the database pool (if available).

pub fn http(&self) -> &MockHttp

Get the mock HTTP client.

pub fn user_id(&self) -> Result<Uuid, ForgeError>

Get the authenticated user’s UUID. Returns 401 if not authenticated.

pub fn has_role(&self, role: &str) -> bool

Check if a specific role is present.

pub fn claim(&self, key: &str) -> Option<&Value>

Get a claim value.

pub fn tenant_id(&self) -> Option<Uuid>

Get the tenant ID (if set).

pub fn job_dispatch(&self) -> &MockJobDispatch

Get the mock job dispatch for verification.

pub fn workflow_dispatch(&self) -> &MockWorkflowDispatch

Get the mock workflow dispatch for verification.

pub async fn dispatch_job<T>( &self, job_type: &str, args: T, ) -> Result<Uuid, ForgeError>

where T: Serialize,

Dispatch a job (records for later verification).

pub async fn start_workflow<T>( &self, workflow_name: &str, input: T, ) -> Result<Uuid, ForgeError>

where T: Serialize,

Start a workflow (records for later verification).

pub fn env_mock(&self) -> &MockEnvProvider

Get the mock env provider for verification.

Trait Implementations

impl EnvAccess for TestMcpToolContext

fn env_provider(&self) -> &dyn EnvProvider

Get the environment provider.

fn env(&self, key: &str) -> Option<String>

Get an environment variable.

fn env_or(&self, key: &str, default: &str) -> String

Get an environment variable with a default value.

fn env_require(&self, key: &str) -> Result<String, ForgeError>

Get a required environment variable.

fn env_parse<T>(&self, key: &str) -> Result<T, ForgeError>

where T: FromStr, <T as FromStr>::Err: Display,

Get an environment variable and parse it to the specified type.

fn env_parse_or<T>(&self, key: &str, default: T) -> Result<T, ForgeError>

where T: FromStr, <T as FromStr>::Err: Display,

Get an environment variable and parse it, with a default.

fn env_contains(&self, key: &str) -> bool

Check if an environment variable is set.