π The fast, Pythonic way to build MCP servers and clients.
Allow background task logging without a session (#5806)
Luck43ed9727f49d
diff --git a/fastmcp_slim/fastmcp/server/context.py b/fastmcp_slim/fastmcp/server/context.pyindex 5e27912a7..caa2e4078 100644--- a/fastmcp_slim/fastmcp/server/context.py+++ b/fastmcp_slim/fastmcp/server/context.py@@ -643,7 +643,16 @@ class Context:# Resolve the client-requested minimum level (set via logging/setLevel),# falling back to the server's configured default.min_level = self.fastmcp.client_log_level- session = self.session+ try:+ session = self.session+ except RuntimeError:+ from fastmcp.server.dependencies import _background_task_session_id++ # Background workers have no live session; a client-set level lives+ # on a connection they cannot reach, so the server default applies.+ if _background_task_session_id.get() is None:+ raise+ session = Nonesession_min = _get_client_log_level(session)if session_min is not None:min_level = session_min@@ -1350,7 +1359,7 @@ def _detached_request_context(context: Context) -> ServerRequestContext:_CONNECTION_LOG_LEVEL_KEY = "_fastmcp_client_log_level"-def _get_client_log_level(session: ServerSession) -> LoggingLevel | None:+def _get_client_log_level(session: ServerSession | None) -> LoggingLevel | None:"""Return the minimum log level the client set with logging/setLevel, if any.v2 constructs sessions per-request, so the stable identity is the@@ -1367,7 +1376,7 @@ def _get_client_log_level(session: ServerSession) -> LoggingLevel | None:async def _log_to_server_and_client(data: LogData,- session: ServerSession,+ session: ServerSession | None,level: LoggingLevel,logger_name: str | None = None,related_request_id: str | None = None,@@ -1392,6 +1401,10 @@ async def _log_to_server_and_client(extra={k: v for k, v in (data.extra or {}).items() if k not in reserved},)+ # Background workers have no live MCP session or client back-channel.+ if session is None:+ return+# Deprecated upstream in SDK v2 but deliberately kept per compat directive;# removed with the multi-round-trip follow-up.await session.send_log_message( # ty: ignore[deprecated]diff --git a/tests/server/test_context.py b/tests/server/test_context.pyindex 2ec1871b6..09cd38b3e 100644--- a/tests/server/test_context.py+++ b/tests/server/test_context.py@@ -697,3 +697,44 @@ class TestContextToClientLogger:for r in caplog.recordsif r.name == to_client_logger.name] == [(logging.DEBUG, "DEBUG", f"Sending {method.upper()} to client: hello")]+++async def test_background_context_logging_without_session():+ from fastmcp.server.dependencies import _background_task_session_id++ context = Context(+ fastmcp=FastMCP("test"),+ task_id="task-1",+ origin_request_id="request-1",+ )+ token = _background_task_session_id.set("session-1")+ try:+ await context.info("worker progress")+ finally:+ _background_task_session_id.reset(token)+++async def test_background_context_logging_honors_server_log_level(+ caplog: pytest.LogCaptureFixture,+):+ from fastmcp.server.dependencies import _background_task_session_id++ mcp = FastMCP("test", client_log_level="warning")+ context = Context(+ fastmcp=mcp,+ task_id="task-1",+ origin_request_id="request-1",+ )+ to_client = logging.getLogger("fastmcp.server.context.to_client")+ to_client.setLevel(logging.DEBUG)+ token = _background_task_session_id.set("snapshot-session")+ try:+ await context.info("suppressed")+ await context.warning("emitted")+ finally:+ _background_task_session_id.reset(token)+ to_client.setLevel(logging.NOTSET)++ assert [r.getMessage() for r in caplog.records if r.name == to_client.name] == [+ "Sending WARNING to client: emitted"+ ]