Skip to content

πŸš€ The fast, Pythonic way to build MCP servers and clients.

fix(client): keep the response cache inert on legacy connections (#6298) (#6321)

xunWhale431b2ed4524c
diff --git a/fastmcp_slim/fastmcp/client/client.py b/fastmcp_slim/fastmcp/client/client.py
index 2cd1838f2..8ed1e187d 100644
--- a/fastmcp_slim/fastmcp/client/client.py
+++ b/fastmcp_slim/fastmcp/client/client.py
@@ -1354,6 +1354,8 @@ class Client(
return await send()
# A closed (or never-entered) client must raise, never serve cached entries.
_ = self.session
+ if self.protocol_version not in MODERN_PROTOCOL_VERSIONS:
+ return await send()
if cursor is not None:
# Continuation pages skip the cache; an expired cursor means the listing
# changed, so evict (spec SHOULD) and re-raise.
diff --git a/tests/client/client/test_response_cache.py b/tests/client/client/test_response_cache.py
index 1d769ccdc..11ea4bba2 100644
--- a/tests/client/client/test_response_cache.py
+++ b/tests/client/client/test_response_cache.py
@@ -161,6 +161,37 @@ class TestEraGating:
assert cache is not None
assert await cache.read("tools/list", "") is None
+ async def test_legacy_with_default_ttl_cache_is_inert(self):
+ """When default_ttl_ms is configured, legacy mode must keep the cache inert:
+ neither writing into the cache nor serving hits from it (#6298)."""
+ server = _cached_server()
+ config = CacheConfig(target_id="demo", default_ttl_ms=60000)
+ async with Client(server, mode="legacy", cache=config) as client:
+ await client.list_tools()
+ cache = client._response_cache
+ assert cache is not None
+ # Inert: nothing was written to the cache
+ assert await cache.read("tools/list", "") is None
+
+ # Inert: even if the cache were populated, legacy does not read from it
+ await cache.write(
+ "tools/list", "", mcp_types.ListToolsResult(tools=[]), 0, "use"
+ )
+
+ calls = {"n": 0}
+ original = client.session.list_tools
+
+ async def spy(**kwargs):
+ calls["n"] += 1
+ return await original(**kwargs)
+
+ client.session.list_tools = spy # type: ignore[method-assign]
+ second = await client.list_tools()
+
+ # Wire request made, cached empty list was ignored
+ assert calls["n"] == 1
+ assert [t.name for t in second] == ["add"]
+
class TestNewIndependentCache:
async def test_new_gets_independent_cache(self):