> ## Documentation Index
> Fetch the complete documentation index at: https://fastmcp-docs-v3-beta2-feature-tracking.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# filesystem_discovery
# `fastmcp.server.providers.filesystem_discovery`
File discovery and module import utilities for filesystem-based routing.
This module provides functions to:
1. Discover Python files in a directory tree
2. Import modules (as packages if **init**.py exists, else directly)
3. Extract decorated components (Tool, Resource, Prompt objects) from imported modules
## Functions
### `discover_files`
```python theme={null}
discover_files(root: Path) -> list[Path]
```
Recursively discover all Python files under a directory.
Excludes **init**.py files (they're for package structure, not components).
**Args:**
* `root`: Root directory to scan.
**Returns:**
* List of .py file paths, sorted for deterministic order.
### `import_module_from_file`
```python theme={null}
import_module_from_file(file_path: Path) -> ModuleType
```
Import a Python file as a module.
If the file is part of a package (directory has **init**.py), imports
it as a proper package member (relative imports work). Otherwise,
imports directly using spec\_from\_file\_location.
**Args:**
* `file_path`: Path to the Python file.
**Returns:**
* The imported module.
**Raises:**
* `ImportError`: If the module cannot be imported.
### `extract_components`
```python theme={null}
extract_components(module: ModuleType) -> list[FastMCPComponent]
```
Extract all MCP components from a module.
Scans all module attributes for instances of Tool, Resource,
ResourceTemplate, or Prompt objects created by standalone decorators,
or functions decorated with @tool/@resource/@prompt that have **fastmcp** metadata.
**Args:**
* `module`: The imported module to scan.
**Returns:**
* List of component objects (Tool, Resource, ResourceTemplate, Prompt).
### `discover_and_import`
```python theme={null}
discover_and_import(root: Path) -> DiscoveryResult
```
Discover files, import modules, and extract components.
This is the main entry point for filesystem-based discovery.
**Args:**
* `root`: Root directory to scan.
**Returns:**
* DiscoveryResult with components and any failed files.
## Classes
### `DiscoveryResult`
Result of filesystem discovery.