mirror of
https://github.com/PrefectHQ/fastmcp.git
synced 2026-08-23 14:04:18 +02:00
47d3044b06
Docket provides background task execution and is now always available for all FastMCP servers. Only `enable_tasks` remains to control the SEP-1686 task protocol support. Changes: - Remove `enable_docket` setting and related validation - Docket/Worker lifecycle is always active in server lifespan - CurrentDocket and CurrentWorker dependencies work without config - Add server readiness signaling via `_started` event - Fix test timing issues with proper port probing 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
61 lines
1.5 KiB
Markdown
61 lines
1.5 KiB
Markdown
# FastMCP Tasks Example
|
|
|
|
Demonstrates background task execution with Docket, including progress tracking, distributed backends, and CLI worker management.
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
# From the fastmcp root directory
|
|
uv sync
|
|
|
|
# Start Redis
|
|
cd examples/tasks
|
|
docker compose up -d
|
|
|
|
# Load environment (or source .envrc manually)
|
|
direnv allow
|
|
|
|
# Run the server
|
|
fastmcp run server.py
|
|
```
|
|
|
|
For single-process mode without Redis, set `FASTMCP_DOCKET_URL=memory://` (note: CLI workers won't work).
|
|
|
|
## Running the Client
|
|
|
|
```bash
|
|
# Background execution with progress callbacks
|
|
python examples/tasks/client.py --duration 10
|
|
|
|
# Immediate execution (blocks)
|
|
python examples/tasks/client.py immediate --duration 5
|
|
```
|
|
|
|
## Starting Additional Workers
|
|
|
|
With Redis, you can run additional workers to process tasks in parallel:
|
|
|
|
```bash
|
|
fastmcp tasks worker server.py
|
|
|
|
# Configure via environment:
|
|
export FASTMCP_DOCKET_CONCURRENCY=20
|
|
fastmcp tasks worker server.py
|
|
```
|
|
|
|
**Backend options:**
|
|
- `memory://` - Single-process only (default)
|
|
- `redis://` - Distributed, multi-process (Redis or Valkey)
|
|
|
|
## Environment Variables
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `FASTMCP_ENABLE_TASKS` | `false` | Enable MCP task protocol (SEP-1686) |
|
|
| `FASTMCP_DOCKET_URL` | `memory://` | Docket backend URL |
|
|
|
|
## Learn More
|
|
|
|
- [FastMCP Tasks Documentation](https://gofastmcp.com/docs/tasks)
|
|
- [Docket Documentation](https://github.com/PrefectHQ/docket)
|
|
- [MCP Task Protocol (SEP-1686)](https://spec.modelcontextprotocol.io/specification/architecture/tasks/)
|