π The fast, Pythonic way to build MCP servers and clients.
Centralize task capabilities, add component filtering
Chris Guidrydc00f5c2bb51
diff --git a/src/fastmcp/client/transports.py b/src/fastmcp/client/transports.pyindex 5f987a1f9..439507179 100644--- a/src/fastmcp/client/transports.py+++ b/src/fastmcp/client/transports.py@@ -36,6 +36,7 @@ from fastmcp.client.auth.oauth import OAuthfrom fastmcp.mcp_config import MCPConfig, infer_transport_type_from_urlfrom fastmcp.server.dependencies import get_http_headersfrom fastmcp.server.server import FastMCP+from fastmcp.server.tasks.capabilities import get_task_capabilitiesfrom fastmcp.utilities.logging import get_loggerfrom fastmcp.utilities.mcp_server_config.v1.environments.uv import UVEnvironment@@ -856,14 +857,7 @@ class FastMCPTransport(ClientTransport):_enter_server_lifespan(server=self.server),):# Build experimental capabilities- # Declare SEP-1686 task support- experimental_capabilities = {- "tasks": {- "tools": True,- "prompts": True,- "resources": True,- }- }+ experimental_capabilities = get_task_capabilities()tg.start_soon(lambda: self.server._mcp_server.run(diff --git a/src/fastmcp/server/http.py b/src/fastmcp/server/http.pyindex 0ac6598d4..41722c6cf 100644--- a/src/fastmcp/server/http.py+++ b/src/fastmcp/server/http.py@@ -21,6 +21,7 @@ from starlette.types import Lifespan, Receive, Scope, Sendfrom fastmcp.server.auth import AuthProviderfrom fastmcp.server.auth.middleware import RequireAuthMiddleware+from fastmcp.server.tasks.capabilities import get_task_capabilitiesfrom fastmcp.utilities.logging import get_loggerif TYPE_CHECKING:@@ -160,19 +161,7 @@ def create_sse_app(async def handle_sse(scope: Scope, receive: Receive, send: Send) -> Response:async with sse.connect_sse(scope, receive, send) as streams:# Build experimental capabilities- # Declare SEP-1686 task support per final spec (lines 49-63)- # Nested structure: {list: {}, cancel: {}, requests: {tools: {call: {}}}}- experimental_capabilities = {- "tasks": {- "list": {},- "cancel": {},- "requests": {- "tools": {"call": {}},- "prompts": {"get": {}},- "resources": {"read": {}},- },- }- }+ experimental_capabilities = get_task_capabilities()await server._mcp_server.run(streams[0],diff --git a/src/fastmcp/server/server.py b/src/fastmcp/server/server.pyindex 8c8c9193b..eea0483cd 100644--- a/src/fastmcp/server/server.py+++ b/src/fastmcp/server/server.py@@ -74,6 +74,7 @@ from fastmcp.server.http import ()from fastmcp.server.low_level import LowLevelServerfrom fastmcp.server.middleware import Middleware, MiddlewareContext+from fastmcp.server.tasks.capabilities import get_task_capabilitiesfrom fastmcp.server.tasks.config import TaskConfigfrom fastmcp.server.tasks.handlers import (handle_prompt_as_task,@@ -690,7 +691,11 @@ class FastMCP(Generic[LifespanResultT]):async with fastmcp.server.context.Context(fastmcp=self):# Get resource including from mounted serversresource = await self._get_resource_with_task_config(str(uri))- if resource and hasattr(resource, "task_config"):+ if (+ resource+ and self._should_enable_component(resource)+ and hasattr(resource, "task_config")+ ):task_mode = resource.task_config.mode # type: ignore[union-attr]# Enforce mode="required" - must have task metadata@@ -817,7 +822,12 @@ class FastMCP(Generic[LifespanResultT]):async with fastmcp.server.context.Context(fastmcp=self):prompts = await self.get_prompts()prompt = prompts.get(name)- if prompt and hasattr(prompt, "task_config") and prompt.task_config:+ if (+ prompt+ and self._should_enable_component(prompt)+ and hasattr(prompt, "task_config")+ and prompt.task_config+ ):task_mode = prompt.task_config.mode # type: ignore[union-attr]# Enforce mode="required" - must have task metadata@@ -1542,7 +1552,11 @@ class FastMCP(Generic[LifespanResultT]):# Get tool from local manager, mounted servers, or proxytool = await self._get_tool_with_task_config(key)- if tool and hasattr(tool, "task_config"):+ if (+ tool+ and self._should_enable_component(tool)+ and hasattr(tool, "task_config")+ ):task_mode = tool.task_config.mode # type: ignore[union-attr]# Enforce mode="required" - must have task metadata@@ -2476,19 +2490,7 @@ class FastMCP(Generic[LifespanResultT]):)# Build experimental capabilities- # Declare SEP-1686 task support per final spec (lines 49-63)- # Nested structure: {list: {}, cancel: {}, requests: {tools: {call: {}}}}- experimental_capabilities = {- "tasks": {- "list": {},- "cancel": {},- "requests": {- "tools": {"call": {}},- "prompts": {"get": {}},- "resources": {"read": {}},- },- }- }+ experimental_capabilities = get_task_capabilities()await self._mcp_server.run(read_stream,diff --git a/src/fastmcp/server/tasks/__init__.py b/src/fastmcp/server/tasks/__init__.pyindex 43eef5d80..10b59b66b 100644--- a/src/fastmcp/server/tasks/__init__.py+++ b/src/fastmcp/server/tasks/__init__.py@@ -3,43 +3,19 @@This module implements protocol-level background task execution for MCP servers."""+from fastmcp.server.tasks.capabilities import get_task_capabilitiesfrom fastmcp.server.tasks.config import TaskConfig, TaskMode-from fastmcp.server.tasks.converters import (- convert_prompt_result,- convert_resource_result,- convert_tool_result,-)-from fastmcp.server.tasks.handlers import (- handle_prompt_as_task,- handle_resource_as_task,- handle_tool_as_task,-)from fastmcp.server.tasks.keys import (build_task_key,get_client_task_id_from_key,parse_task_key,)-from fastmcp.server.tasks.protocol import (- tasks_cancel_handler,- tasks_get_handler,- tasks_list_handler,- tasks_result_handler,-)__all__ = ["TaskConfig","TaskMode","build_task_key",- "convert_prompt_result",- "convert_resource_result",- "convert_tool_result","get_client_task_id_from_key",- "handle_prompt_as_task",- "handle_resource_as_task",- "handle_tool_as_task",+ "get_task_capabilities","parse_task_key",- "tasks_cancel_handler",- "tasks_get_handler",- "tasks_list_handler",- "tasks_result_handler",]diff --git a/src/fastmcp/server/tasks/capabilities.py b/src/fastmcp/server/tasks/capabilities.pynew file mode 100644index 000000000..c08371eca--- /dev/null+++ b/src/fastmcp/server/tasks/capabilities.py@@ -0,0 +1,22 @@+"""SEP-1686 task capabilities declaration."""++from typing import Any+++def get_task_capabilities() -> dict[str, Any]:+ """Return the SEP-1686 task capabilities structure.++ This is the standard capabilities map advertised to clients,+ declaring support for list, cancel, and request operations.+ """+ return {+ "tasks": {+ "list": {},+ "cancel": {},+ "requests": {+ "tools": {"call": {}},+ "prompts": {"get": {}},+ "resources": {"read": {}},+ },+ }+ }diff --git a/tests/server/tasks/test_task_capabilities.py b/tests/server/tasks/test_task_capabilities.pyindex e1ef1d676..2bafcb707 100644--- a/tests/server/tasks/test_task_capabilities.py+++ b/tests/server/tasks/test_task_capabilities.py@@ -7,6 +7,7 @@ Task protocol is now always enabled.from fastmcp import FastMCPfrom fastmcp.client import Client+from fastmcp.server.tasks import get_task_capabilitiesasync def test_capabilities_include_tasks():@@ -25,11 +26,7 @@ async def test_capabilities_include_tasks():assert init_result.capabilities.experimental is not Noneassert "tasks" in init_result.capabilities.experimentaltasks_cap = init_result.capabilities.experimental["tasks"]- assert tasks_cap == {- "tools": True,- "prompts": True,- "resources": True,- }+ assert tasks_cap == get_task_capabilities()["tasks"]async def test_client_uses_task_capable_session():