Function test_resource_title

tests/server/mcpserver/test_title.py:122–191

Test that resource titles work correctly.

()

@pytest.mark.anyio
async def test_resource_title():
    """Test that resource titles work correctly."""
    mcp = MCPServer(name="ResourceTitleServer")

    # Static resource without title
    def get_basic_data() -> str:  # pragma: no cover
        return "Basic data"

    basic_resource = FunctionResource(
        uri="resource://basic",
        name="basic_resource",
        description="Basic resource",
        fn=get_basic_data,
    )
    mcp.add_resource(basic_resource)

    # Static resource with title
    def get_titled_data() -> str:  # pragma: no cover
        return "Titled data"

    titled_resource = FunctionResource(
        uri="resource://titled",
        name="titled_resource",
        title="User-Friendly Resource",
        description="Resource with title",
        fn=get_titled_data,
    )
    mcp.add_resource(titled_resource)

    # Dynamic resource without title
    @mcp.resource("resource://dynamic/{id}")
    def dynamic_resource(id: str) -> str:  # pragma: no cover
        return f"Data for {id}"

    # Dynamic resource with title (when supported)
    @mcp.resource("resource://titled-dynamic/{id}", title="Dynamic Data")
    def titled_dynamic_resource(id: str) -> str:  # pragma: no cover
        return f"Data for {id}"

    # Start server and connect client
    async with Client(mcp) as client:
        # List resources
        resources_result = await client.list_resources()
        resources = {str(res.uri): res for res in resources_result.resources}

        # Verify basic resource uses name
        assert "resource://basic" in resources
        basic = resources["resource://basic"]
        assert basic.title is None
        assert basic.name == "basic_resource"

        # Verify resource with title
        assert "resource://titled" in resources
        titled = resources["resource://titled"]
        assert titled.title == "User-Friendly Resource"

        # List resource templates
        templates_result = await client.list_resource_templates()