2 commits

Author	SHA1	Message	Date
Jeremiah Lowin	ede8ff6703	Convert mounted servers to MountedProvider (#2635) ... * Simplify Provider interface and consolidate docket registration - Remove get_http_routes from Provider (unused) - Remove ProviderLifespanConfig, _base_lifespan, _register_tasks - Remove supports_tasks flag from Provider.__init__ - Consolidate all docket registration in server._docket_lifespan() - Simplify lifespan() to take no parameters - Move MountedProvider to separate module * Fix control flow in ComponentService resource methods * Move providers to server/providers * Ensure MountedProvider get_* methods go through middleware * Fix get_resource to only return concrete resources Reverts template-checking in get_resource that broke task execution. Tasks need access to the original template, not instantiated resources. * Move prefix utilities into mounted.py, deprecate import_server - Add resource prefix functions (add/remove/has_resource_prefix) to mounted.py - Deprecate import_server with warning to use mount() instead - Add tool_names uniqueness validation in MountedProvider * Fix provider iteration order and remove dead _is_mounted flag - Remove unused _is_mounted flag (MountedProvider.lifespan() calls _lifespan not _lifespan_manager, so the flag was never checked) - Fix provider iteration: change reversed() to forward order in execution methods (_call_tool, _read_resource_middleware, _get_prompt_content_middleware) to match documented "first non-None wins" semantics - Fix ComponentService to handle prefix-less mounted servers using _strip_tool_prefix()/_strip_resource_prefix() methods - Update conflict resolution tests to expect first-registered provider wins - Add regression tests for Docket behavior and prefix-less ComponentService * Add TaskComponents type and exception handling for provider task registration - Create TaskComponents dataclass with FunctionTool/FunctionResource/etc. types for proper typing of get_tasks() return value - Add try/except wrapper around provider.get_tasks() in _docket_lifespan for consistent error handling (warn + continue or raise based on settings) - Remove type: ignore comments from server.py task registration loop	2025-12-17 22:21:51 -05:00
Jeremiah Lowin	0e5a8fed6c	feat: Provider abstraction for dynamic MCP components (#2622) ... * feat: add Provider abstraction for dynamic components Introduces a `Provider` base class that allows dynamic provision of tools, resources, and prompts at runtime. Providers are queried after static components, enabling database-backed tools, external integrations, and other dynamic component sources. ```python from fastmcp import FastMCP, Provider class DatabaseProvider(Provider): async def list_tools(self, context): return await db.fetch_tools() mcp = FastMCP("Server", providers=[DatabaseProvider()]) ``` * Add execution methods to Provider interface Enable providers to customize how components are executed, not just listed. This unlocks MountedProvider (future) invoking wrapped server middleware. - call_tool, read_resource, read_resource_template, render_prompt - Server uses provider execution methods after filter checks - Default implementations delegate to component methods * Apply unified error handling to provider execution - Document error semantics: list_* gracefully degrades, execution propagates - Wrap provider call_tool/read_resource/render_prompt with masking logic - ToolError/ResourceError/PromptError pass through, others wrapped	2025-12-16 22:05:43 -05:00