mirror of
https://github.com/PrefectHQ/fastmcp.git
synced 2026-08-09 15:19:10 +02:00
41 lines
1.5 KiB
Text
41 lines
1.5 KiB
Text
---
|
|
title: handlers
|
|
sidebarTitle: handlers
|
|
---
|
|
|
|
# `fastmcp.server.tasks.handlers`
|
|
|
|
|
|
SEP-1686 task execution handlers.
|
|
|
|
Handles queuing tool/prompt/resource executions to Docket as background tasks.
|
|
|
|
|
|
## Functions
|
|
|
|
### `submit_to_docket` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/src/fastmcp/server/tasks/handlers.py#L39" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
submit_to_docket(task_type: Literal['tool', 'resource', 'template', 'prompt'], key: str, component: Tool | Resource | ResourceTemplate | Prompt, arguments: dict[str, Any] | None = None, task_meta: TaskMeta | None = None) -> mcp.types.CreateTaskResult
|
|
```
|
|
|
|
|
|
Submit any component to Docket for background execution (SEP-1686).
|
|
|
|
Unified handler for all component types. Called by component's internal
|
|
methods (_run, _read, _render) when task metadata is present and mode allows.
|
|
|
|
Queues the component's method to Docket, stores raw return values,
|
|
and converts to MCP types on retrieval.
|
|
|
|
**Args:**
|
|
- `task_type`: Component type for task key construction
|
|
- `key`: The component key as seen by MCP layer (with namespace prefix)
|
|
- `component`: The component instance (Tool, Resource, ResourceTemplate, Prompt)
|
|
- `arguments`: Arguments/params (None for Resource which has no args)
|
|
- `task_meta`: Task execution metadata. If task_meta.ttl is provided, it
|
|
overrides the server default (docket.execution_ttl).
|
|
|
|
**Returns:**
|
|
- Task stub with proper Task object
|
|
|