π The fast, Pythonic way to build MCP servers and clients.
fix: preserve empty session visibility selections (#5944)
Himanshu Chawla5910eb240f9f
diff --git a/docs/servers/visibility.mdx b/docs/servers/visibility.mdxindex 376424c08..8ff71867c 100644--- a/docs/servers/visibility.mdx+++ b/docs/servers/visibility.mdx@@ -386,6 +386,8 @@ async def enable_recent_tools(ctx: Context) -> str:return "Recent tools enabled"```+An explicit empty `names` or `keys` set matches no components, even when combined with other filters, unless `match_all=True`. Omit the parameter or pass `None` to leave that criterion unrestricted.+### Sessions on MCP 2026-07-28MCP 2026-07-28 connections, which FastMCP clients negotiate by default, have no session. On those connections, session rules are scoped to the authenticated user, the same identity [`UserSession`](/servers/sessions) uses, so they apply to every connection that user makes. Without authentication, stdio servers keep one set of rules for the process, because a stdio server serves a single client. An unauthenticated HTTP request carries nothing that identifies its client between requests, so `enable_components()`, `disable_components()`, and `reset_visibility()` raise an error rather than changing what every client sees.diff --git a/fastmcp_slim/fastmcp/server/transforms/visibility.py b/fastmcp_slim/fastmcp/server/transforms/visibility.pyindex 664ccd3f4..42cfafd6b 100644--- a/fastmcp_slim/fastmcp/server/transforms/visibility.py+++ b/fastmcp_slim/fastmcp/server/transforms/visibility.py@@ -396,8 +396,10 @@ def create_visibility_transforms(rules: list[dict[str, Any]]) -> list[Visibilitytransforms.append(Visibility(params["enabled"],- names=set(params["names"]) if params.get("names") else None,- keys=set(params["keys"]) if params.get("keys") else None,+ names=(+ set(params["names"]) if params.get("names") is not None else None+ ),+ keys=(set(params["keys"]) if params.get("keys") is not None else None),version=version,tags=set(params["tags"]) if params.get("tags") else None,components=(@@ -452,8 +454,8 @@ async def enable_components(# Create new rule dictrule: dict[str, Any] = {"enabled": True,- "names": list(names) if names else None,- "keys": list(keys) if keys else None,+ "names": list(names) if names is not None else None,+ "keys": list(keys) if keys is not None else None,"version": ({"gte": version.gte, "lt": version.lt, "eq": version.eq}if version@@ -506,8 +508,8 @@ async def disable_components(# Create new rule dictrule: dict[str, Any] = {"enabled": False,- "names": list(names) if names else None,- "keys": list(keys) if keys else None,+ "names": list(names) if names is not None else None,+ "keys": list(keys) if keys is not None else None,"version": ({"gte": version.gte, "lt": version.lt, "eq": version.eq}if versiondiff --git a/tests/server/test_session_visibility_empty_filters.py b/tests/server/test_session_visibility_empty_filters.pynew file mode 100644index 000000000..f20b9fbe4--- /dev/null+++ b/tests/server/test_session_visibility_empty_filters.py@@ -0,0 +1,55 @@+"""Session visibility must preserve explicit empty component selections."""++from typing import Literal++import pytest++from fastmcp import Client, FastMCP+from fastmcp.server.context import Context++[email protected]("selector", ["names", "keys"])[email protected]("selection", ["empty", "matching", "nonmatching", "omitted"])[email protected]("enabled", [True, False])+async def test_session_selection_matches_global_selection(+ selector: Literal["names", "keys"],+ selection: Literal["empty", "matching", "nonmatching", "omitted"],+ enabled: bool,+) -> None:+ server = FastMCP("Selection")+ names: set[str] | None = None+ keys: set[str] | None = None+ if selection != "omitted":+ name = "report" if selection == "matching" else "other"+ value = name if selector == "names" else f"tool:{name}@"+ selected = set() if selection == "empty" else {value}+ if selector == "names":+ names = selected+ else:+ keys = selected++ @server.tool(tags={"finance"})+ def report() -> str:+ return "report"++ @server.tool+ async def update_visibility(ctx: Context) -> list[str]:+ if enabled:+ await ctx.enable_components(tags={"finance"}, names=names, keys=keys)+ else:+ await ctx.disable_components(tags={"finance"}, names=names, keys=keys)+ return sorted(tool.name for tool in await ctx.fastmcp.list_tools())++ if enabled:+ server.disable(tags={"finance"})+ server.enable(tags={"finance"}, names=names, keys=keys)+ else:+ server.disable(tags={"finance"}, names=names, keys=keys)++ async with Client(server) as client:+ expected = sorted(tool.name for tool in await client.list_tools())+ result = await client.call_tool("update_visibility")++ assert result.data == expected+ should_match = selection in {"matching", "omitted"}+ assert ("report" in result.data) is (enabled if should_match else not enabled)