Skip to content

πŸš€ 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.py
index 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 = None
session_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.py
index 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.records
if 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"
+ ]