@mcp-utils/timeout

Wraps MCP tool handler functions with configurable timeout enforcement, automatically terminating execution if a handler exceeds the specified duration. Uses AbortSignal propagation to cascade timeout cancellation through async call chains, allowing downstream operations (API calls, database queries, subprocess operations) to detect and respond to timeout events via standard abort mechanisms rather than hard process termination.

Automatically threads AbortSignal instances through MCP tool handler execution contexts, making timeout and cancellation signals available to all downstream async operations without explicit parameter passing. Integrates with the vurb framework's context management to ensure signals flow through nested tool invocations, middleware, and async utilities while maintaining proper signal inheritance and avoiding signal loss across async boundaries.

Provides timeout configuration and lifecycle hooks integrated with the vurb framework, allowing developers to set timeout policies at the MCP server level, override per-tool, and hook into timeout events (pre-timeout warnings, post-timeout cleanup). Manages AbortController lifecycle, signal cleanup, and ensures no resource leaks when timeouts occur, with integration points for logging, metrics, and custom cancellation handlers.

Implements graceful cancellation semantics for MCP tool handlers by triggering AbortSignal when timeout occurs, allowing handlers to catch AbortError and execute cleanup logic (close database connections, cancel in-flight API requests, release file handles). Uses standard Node.js AbortController patterns to ensure cleanup runs before the handler promise rejects, preventing resource leaks and orphaned operations.

Provides a composable wrapper pattern for MCP tool handlers that can be stacked with other middleware and decorators, allowing timeout enforcement to coexist with logging, validation, rate-limiting, and other cross-cutting concerns. Maintains handler signature compatibility and integrates with MCP's tool registration system, enabling developers to apply timeouts to existing tools without refactoring handler code.