Skip to content

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

3.0 KB
Raw Blame
"""Dependencies declared in `Annotated` metadata resolve like `Depends()` defaults."""

from typing import Annotated

import pytest

from fastmcp import FastMCP
from fastmcp.client import Client
from fastmcp.dependencies import CurrentContext, CurrentFastMCP, Depends
from fastmcp.server.context import Context


def get_config() -> dict[str, str]:
    return {"api_url": "https://api.example.com"}


Config = Annotated[dict[str, str], Depends(get_config)]


async def test_tool_resolves_annotated_dependency_outside_its_schema():
    mcp = FastMCP()

    @mcp.tool
    async def fetch(query: str, config: Annotated[dict, Depends(get_config)]) -> str:
        return f"{query} from {config['api_url']}"

    async with Client(mcp) as client:
        (tool,) = await client.list_tools()
        result = await client.call_tool("fetch", {"query": "users"})

    assert list(tool.input_schema["properties"]) == ["query"]
    assert result.data == "users from https://api.example.com"


async def test_type_alias_carries_the_dependency():
    mcp = FastMCP()

    @mcp.tool
    async def fetch(config: Config) -> str:
        return config["api_url"]

    async with Client(mcp) as client:
        (tool,) = await client.list_tools()
        result = await client.call_tool("fetch", {})

    assert tool.input_schema.get("properties", {}) == {}
    assert result.data == "https://api.example.com"


async def test_prompt_and_template_resolve_annotated_dependencies():
    mcp = FastMCP()

    @mcp.prompt
    def describe(topic: str, config: Config) -> str:
        return f"{topic} at {config['api_url']}"

    @mcp.resource("config://{key}")
    def read_config(key: str, config: Config) -> str:
        return config[key]

    async with Client(mcp) as client:
        (prompt,) = await client.list_prompts()
        rendered = await client.get_prompt("describe", {"topic": "search"})
        contents = await client.read_resource("config://api_url")

    assert [argument.name for argument in prompt.arguments or []] == ["topic"]
    assert rendered.messages[0].content.text == "search at https://api.example.com"
    assert contents[0].text == "https://api.example.com"


def test_annotated_dependency_with_a_depends_default_is_rejected():
    mcp = FastMCP()

    with pytest.raises(TypeError):

        @mcp.tool
        async def fetch(
            config: Annotated[dict, Depends(get_config)] = Depends(get_config),
        ) -> str:
            return config["api_url"]


async def test_builtin_dependencies_provide_values_as_annotations():
    mcp = FastMCP("annotated-builtins")

    @mcp.tool
    async def whoami(
        ctx: Annotated[Context, CurrentContext()],
        server: Annotated[FastMCP, CurrentFastMCP()],
    ) -> str:
        return f"{ctx.fastmcp.name}/{server.name}"

    async with Client(mcp) as client:
        (tool,) = await client.list_tools()
        result = await client.call_tool("whoami", {})

    assert tool.input_schema.get("properties", {}) == {}
    assert result.data == "annotated-builtins/annotated-builtins"