mirror of
https://github.com/PrefectHQ/fastmcp.git
synced 2026-08-17 19:19:12 +02:00
9d5ffa86b3Co-authored-by: marvin-context-protocol[bot] <225465937+marvin-context-protocol[bot]@users.noreply.github.com>
115 lines
4 KiB
Text
115 lines
4 KiB
Text
---
|
|
title: components
|
|
sidebarTitle: components
|
|
---
|
|
|
|
# `fastmcp.utilities.components`
|
|
|
|
## Classes
|
|
|
|
### `FastMCPMeta` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/utilities/components.py#L21" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
### `FastMCPComponent` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/utilities/components.py#L34" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
|
|
Base class for FastMCP tools, prompts, resources, and resource templates.
|
|
|
|
|
|
**Methods:**
|
|
|
|
#### `make_key` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/utilities/components.py#L80" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
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` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/utilities/components.py#L94" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
key(self) -> str
|
|
```
|
|
|
|
The globally unique lookup key for this component.
|
|
|
|
Format: "{key_prefix}:{identifier}" e.g. "tool:my_tool", "resource:file://x.txt"
|
|
|
|
Subclasses should override this to use their specific identifier.
|
|
Base implementation uses name.
|
|
|
|
|
|
#### `get_meta` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/utilities/components.py#L104" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
get_meta(self, include_fastmcp_meta: bool | None = None) -> dict[str, Any] | None
|
|
```
|
|
|
|
Get the meta information about the component.
|
|
|
|
If include_fastmcp_meta is True, a `_fastmcp` key will be added to the
|
|
meta, containing a `tags` field with the tags of the component.
|
|
|
|
|
|
#### `enable` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/utilities/components.py#L138" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
enable(self) -> None
|
|
```
|
|
|
|
Removed in 3.0. Use server.enable(keys=[...]) instead.
|
|
|
|
|
|
#### `disable` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/utilities/components.py#L145" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
disable(self) -> None
|
|
```
|
|
|
|
Removed in 3.0. Use server.disable(keys=[...]) instead.
|
|
|
|
|
|
#### `copy` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/utilities/components.py#L152" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
copy(self) -> Self
|
|
```
|
|
|
|
Create a copy of the component.
|
|
|
|
|
|
#### `register_with_docket` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/utilities/components.py#L156" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
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` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/utilities/components.py#L164" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
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).
|
|
|