components

fastmcp.utilities.components

Functions

get_fastmcp_metadata

get_fastmcp_metadata(meta: dict[str, Any] | None) -> FastMCPMeta

Extract FastMCP metadata from a component’s meta dict.

Handles both the current fastmcp namespace and the legacy _fastmcp namespace for compatibility with older FastMCP servers.

Classes

FastMCPMeta

FastMCPComponent

Base class for FastMCP tools, prompts, resources, and resource templates.

Methods:

make_key

make_key(cls, identifier: str) -> str

Construct the lookup key for this component type.

Args:

• identifier: The raw identifier (name for tools/prompts, uri for resources)

Returns:

• A prefixed key like “tool:name” or “resource:uri”

key

key(self) -> str

The globally unique lookup key for this component.

Format: ”:@” or ”:@” e.g. “tool:my_tool@v2”, “tool:my_tool@”, “resource:file://x.txt@”

The @ suffix is ALWAYS present to enable unambiguous parsing of keys (URIs may contain @ characters, so we always include the delimiter).

Subclasses should override this to use their specific identifier. Base implementation uses name.

get_meta

get_meta(self) -> dict[str, Any]

Get the meta information about the component.

Returns a dict that always includes a fastmcp key containing:

• tags: sorted list of component tags
• version: component version (only if set)

Internal keys (prefixed with _) are stripped from the fastmcp namespace.

enable

enable(self) -> None

Removed in 3.0. Use server.enable(keys=[…]) instead.

disable

disable(self) -> None

Removed in 3.0. Use server.disable(keys=[…]) instead.

copy

copy(self) -> Self

Create a copy of the component.

register_with_docket

register_with_docket(self, docket: Docket) -> None

Register this component with docket for background execution.

No-ops if task_config.mode is “forbidden”. Subclasses override to register their callable (self.run, self.read, self.render, or self.fn).

add_to_docket

add_to_docket(self, docket: Docket, *args: Any, **kwargs: Any) -> Execution

Schedule this component for background execution via docket.

Subclasses override this to handle their specific calling conventions:

• Tool: add_to_docket(docket, arguments: dict, **kwargs)
• Resource: add_to_docket(docket, **kwargs)
• ResourceTemplate: add_to_docket(docket, params: dict, **kwargs)
• Prompt: add_to_docket(docket, arguments: dict | None, **kwargs)

The **kwargs are passed through to docket.add() (e.g., key=task_key).

get_span_attributes

get_span_attributes(self) -> dict[str, Any]

Return span attributes for telemetry.

Subclasses should call super() and merge their specific attributes.