π The fast, Pythonic way to build MCP servers and clients.
fix: preserve annotations, meta, title, icons when creating resources from templates (#4061)
Bill Easton01b971d80da2
diff --git a/fastmcp_slim/fastmcp/resources/template.py b/fastmcp_slim/fastmcp/resources/template.pyindex 7fb36db69..f3be91a1f 100644--- a/fastmcp_slim/fastmcp/resources/template.py+++ b/fastmcp_slim/fastmcp/resources/template.py@@ -442,6 +442,10 @@ class FunctionResourceTemplate(ResourceTemplate):description=self.description,mime_type=self.mime_type,tags=self.tags,+ annotations=self.annotations,+ meta=self.meta,+ title=self.title,+ icons=self.icons,task=self.task_config,auth=self.auth,)diff --git a/fastmcp_slim/fastmcp/server/providers/fastmcp_provider.py b/fastmcp_slim/fastmcp/server/providers/fastmcp_provider.pyindex 9ce1ef6b0..e532da5cb 100644--- a/fastmcp_slim/fastmcp/server/providers/fastmcp_provider.py+++ b/fastmcp_slim/fastmcp/server/providers/fastmcp_provider.py@@ -381,6 +381,11 @@ class FastMCPProviderResourceTemplate(ResourceTemplate):name=self.name,description=self.description,mime_type=self.mime_type,+ tags=self.tags,+ annotations=self.annotations,+ meta=self.meta,+ title=self.title,+ icons=self.icons,)@overloaddiff --git a/tests/resources/test_resource_template_meta.py b/tests/resources/test_resource_template_meta.pyindex b08ef3667..08a1afe56 100644--- a/tests/resources/test_resource_template_meta.py+++ b/tests/resources/test_resource_template_meta.py@@ -1,4 +1,11 @@+from mcp.types import Annotations, Icon++from fastmcp import FastMCPfrom fastmcp.resources import ResourceTemplate+from fastmcp.server.providers.fastmcp_provider import (+ FastMCPProvider,+ FastMCPProviderResourceTemplate,+)class TestResourceTemplateMeta:@@ -23,3 +30,86 @@ class TestResourceTemplateMeta:# MCP template includes fastmcp meta, so check that our meta is includedassert mcp_template.meta is not Noneassert meta_data.items() <= mcp_template.meta.items()+++class TestResourceTemplateFieldPreservation:+ """Regression for #4061: annotations/meta/title/icons must survive+ materialization of a Resource from a ResourceTemplate."""++ def _template(self) -> ResourceTemplate:+ def fn(param: str) -> str:+ return f"value-{param}"++ return ResourceTemplate.from_function(+ fn=fn,+ uri_template="data://{param}",+ name="t",+ title="Human Title",+ meta={"owner": "team-a"},+ icons=[Icon(src="https://example.com/icon.png", mimeType="image/png")],+ annotations=Annotations(priority=0.5, audience=["user"]),+ )++ async def test_function_template_create_resource_preserves_all_fields(self):+ template = self._template()+ resource = await template.create_resource("data://x", {"param": "x"})++ assert resource.title == "Human Title"+ assert resource.meta == {"owner": "team-a"}+ assert resource.annotations is not None+ assert resource.annotations.priority == 0.5+ assert resource.annotations.audience == ["user"]+ assert resource.icons is not None+ assert len(resource.icons) == 1+ assert str(resource.icons[0].src) == "https://example.com/icon.png"++ async def test_created_resource_meta_is_not_aliased_to_template(self):+ """Mutating the materialized resource's meta must not bleed back into+ the template (each materialization must be independent)."""+ template = self._template()+ resource = await template.create_resource("data://x", {"param": "x"})++ assert resource.meta is not None+ resource.meta["mutated"] = True+ assert "mutated" not in (template.meta or {})++ async def test_fastmcp_provider_template_preserves_fields_without_double_wrap(+ self,+ ):+ """The FastMCPProvider path wraps template.get_meta() (already+ namespaced). Re-materializing must not nest fastmcp under fastmcp."""+ sub = FastMCP("sub")++ @sub.resource(+ "data://{param}",+ title="Sub Title",+ meta={"owner": "team-b"},+ icons=[Icon(src="https://example.com/s.png", mimeType="image/png")],+ annotations=Annotations(priority=0.9),+ tags={"alpha"},+ )+ def fn(param: str) -> str:+ return f"sub-{param}"++ provider = FastMCPProvider(sub)+ templates = await provider._list_resource_templates()+ assert len(templates) == 1+ wrapped = templates[0]+ assert isinstance(wrapped, FastMCPProviderResourceTemplate)++ resource = await wrapped.create_resource("data://x", {"param": "x"})++ assert resource.title == "Sub Title"+ assert resource.annotations is not None+ assert resource.annotations.priority == 0.9+ assert resource.icons is not None and len(resource.icons) == 1++ mcp_resource = resource.to_mcp_resource()+ assert mcp_resource.meta is not None+ # User meta survives end-to-end.+ assert mcp_resource.meta.get("owner") == "team-b"+ # Exactly one fastmcp namespace, and it is NOT double-wrapped.+ fastmcp_ns = mcp_resource.meta.get("fastmcp")+ assert isinstance(fastmcp_ns, dict)+ assert "fastmcp" not in fastmcp_ns+ assert "alpha" in fastmcp_ns.get("tags", [])