Skip to content

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

Forward annotations on proxied resources and resource templates (#5499)

Asem ahmeda419c3b82b90
diff --git a/fastmcp_slim/fastmcp/server/providers/proxy.py b/fastmcp_slim/fastmcp/server/providers/proxy.py
index 1e3b5c611..b52d32bd0 100644
--- a/fastmcp_slim/fastmcp/server/providers/proxy.py
+++ b/fastmcp_slim/fastmcp/server/providers/proxy.py
@@ -526,6 +526,7 @@ class ProxyResource(Resource):
description=mcp_resource.description,
mime_type=mcp_resource.mime_type or "text/plain",
icons=mcp_resource.icons,
+ annotations=mcp_resource.annotations,
meta=mcp_resource.meta,
tags=get_fastmcp_metadata(mcp_resource.meta).get("tags", []),
task_config=TaskConfig(mode="forbidden"),
@@ -627,6 +628,7 @@ class ProxyTemplate(ResourceTemplate):
description=mcp_template.description,
mime_type=mcp_template.mime_type or "text/plain",
icons=mcp_template.icons,
+ annotations=mcp_template.annotations,
parameters={}, # Remote templates don't have local parameters
meta=mcp_template.meta,
tags=get_fastmcp_metadata(mcp_template.meta).get("tags", []),
diff --git a/tests/server/providers/proxy/test_proxy_server.py b/tests/server/providers/proxy/test_proxy_server.py
index 997c65700..2a66cc412 100644
--- a/tests/server/providers/proxy/test_proxy_server.py
+++ b/tests/server/providers/proxy/test_proxy_server.py
@@ -10,7 +10,7 @@ import pytest
from anyio import create_task_group
from dirty_equals import Contains
from mcp import MCPError
-from mcp_types import Icon, TextContent, TextResourceContents
+from mcp_types import Annotations, Icon, TextContent, TextResourceContents
from mcp_types.version import MODERN_PROTOCOL_VERSIONS
from pydantic import AnyUrl
@@ -80,6 +80,7 @@ def fastmcp_server():
tags={"wave"},
title="Wave",
icons=[Icon(src="https://example.com/wave-icon.png")],
+ annotations=Annotations(audience=["user"], priority=0.5),
)
def wave() -> str:
return "πŸ‘‹"
@@ -95,6 +96,7 @@ def fastmcp_server():
tags={"users"},
title="User Template",
icons=[Icon(src="https://example.com/user-icon.png")],
+ annotations=Annotations(audience=["assistant"], priority=0.8),
)
async def get_user(user_id: str) -> str:
import json
@@ -532,6 +534,7 @@ class TestResources:
assert wave_resource.title == "Wave"
assert wave_resource.meta == {"fastmcp": {"tags": ["wave"]}}
assert wave_resource.icons == [Icon(src="https://example.com/wave-icon.png")]
+ assert wave_resource.annotations == Annotations(audience=["user"], priority=0.5)
async def test_list_resources_same_as_original(self, fastmcp_server, proxy_server):
async with Client(fastmcp_server) as original_client:
@@ -649,6 +652,9 @@ class TestResourceTemplates:
assert get_user_template.icons == [
Icon(src="https://example.com/user-icon.png")
]
+ assert get_user_template.annotations == Annotations(
+ audience=["assistant"], priority=0.8
+ )
async def test_list_resource_templates_same_as_original(
self, fastmcp_server, proxy_server