mirror of
https://github.com/PrefectHQ/fastmcp.git
synced 2026-08-09 07:09:11 +02:00
6fce4e538fEngine modules (keys, context snapshot, docket lifespan, worker CLI, client handles) move intact; SEP-1686 wire modules park in _legacy_wire for adaptation to SEP-2663. Core keeps task=True declaration on tools only and raises at serve time until the tasks extension is registered. Co-Authored-By: Claude <noreply@anthropic.com>
195 lines
7.3 KiB
Python
195 lines
7.3 KiB
Python
import json
|
|
|
|
import pytest
|
|
from mcp_types import TextContent, TextResourceContents
|
|
from starlette.requests import Request
|
|
|
|
from fastmcp.server.dependencies import CurrentHeaders, CurrentRequest, get_http_request
|
|
from fastmcp.server.server import FastMCP
|
|
from fastmcp.utilities.tests import ASGIServer, asgi_server
|
|
|
|
|
|
def fastmcp_server():
|
|
server = FastMCP()
|
|
|
|
# Add a tool
|
|
@server.tool
|
|
def get_headers_tool() -> dict[str, str]:
|
|
"""Get the HTTP headers from the request."""
|
|
request = get_http_request()
|
|
|
|
return dict(request.headers)
|
|
|
|
@server.resource(uri="request://headers")
|
|
async def get_headers_resource() -> str:
|
|
import json
|
|
|
|
request = get_http_request()
|
|
return json.dumps(dict(request.headers))
|
|
|
|
# Add a prompt
|
|
@server.prompt
|
|
def get_headers_prompt() -> str:
|
|
"""Get the HTTP headers from the request."""
|
|
request = get_http_request()
|
|
|
|
return json.dumps(dict(request.headers))
|
|
|
|
return server
|
|
|
|
|
|
@pytest.fixture
|
|
async def shttp_server():
|
|
"""Start a test server with StreamableHttp transport."""
|
|
server = fastmcp_server()
|
|
async with asgi_server(server, transport="http") as running_server:
|
|
yield running_server
|
|
|
|
|
|
@pytest.fixture
|
|
async def sse_server():
|
|
"""Start a test server with SSE transport."""
|
|
server = fastmcp_server()
|
|
async with asgi_server(server, transport="sse") as running_server:
|
|
yield running_server
|
|
|
|
|
|
async def test_http_headers_resource_shttp(shttp_server: ASGIServer):
|
|
"""Test getting HTTP headers from the server."""
|
|
async with shttp_server.client(headers={"X-DEMO-HEADER": "ABC"}) as client:
|
|
raw_result = await client.read_resource("request://headers")
|
|
assert isinstance(raw_result[0], TextResourceContents)
|
|
json_result = json.loads(raw_result[0].text)
|
|
assert "x-demo-header" in json_result
|
|
assert json_result["x-demo-header"] == "ABC"
|
|
|
|
|
|
async def test_http_headers_resource_sse(sse_server: ASGIServer):
|
|
"""Test getting HTTP headers from the server."""
|
|
async with sse_server.client(headers={"X-DEMO-HEADER": "ABC"}) as client:
|
|
raw_result = await client.read_resource("request://headers")
|
|
assert isinstance(raw_result[0], TextResourceContents)
|
|
json_result = json.loads(raw_result[0].text)
|
|
assert "x-demo-header" in json_result
|
|
assert json_result["x-demo-header"] == "ABC"
|
|
|
|
|
|
async def test_http_headers_tool_shttp(shttp_server: ASGIServer):
|
|
"""Test getting HTTP headers from the server."""
|
|
async with shttp_server.client(headers={"X-DEMO-HEADER": "ABC"}) as client:
|
|
result = await client.call_tool("get_headers_tool")
|
|
assert "x-demo-header" in result.data
|
|
assert result.data["x-demo-header"] == "ABC"
|
|
|
|
|
|
async def test_http_headers_tool_sse(sse_server: ASGIServer):
|
|
async with sse_server.client(headers={"X-DEMO-HEADER": "ABC"}) as client:
|
|
result = await client.call_tool("get_headers_tool")
|
|
assert "x-demo-header" in result.data
|
|
assert result.data["x-demo-header"] == "ABC"
|
|
|
|
|
|
async def test_http_headers_prompt_shttp(shttp_server: ASGIServer):
|
|
"""Test getting HTTP headers from the server."""
|
|
async with shttp_server.client(headers={"X-DEMO-HEADER": "ABC"}) as client:
|
|
result = await client.get_prompt("get_headers_prompt")
|
|
assert isinstance(result.messages[0].content, TextContent)
|
|
json_result = json.loads(result.messages[0].content.text)
|
|
assert "x-demo-header" in json_result
|
|
assert json_result["x-demo-header"] == "ABC"
|
|
|
|
|
|
async def test_http_headers_prompt_sse(sse_server: ASGIServer):
|
|
"""Test getting HTTP headers from the server."""
|
|
async with sse_server.client(headers={"X-DEMO-HEADER": "ABC"}) as client:
|
|
result = await client.get_prompt("get_headers_prompt")
|
|
assert isinstance(result.messages[0].content, TextContent)
|
|
json_result = json.loads(result.messages[0].content.text)
|
|
assert "x-demo-header" in json_result
|
|
assert json_result["x-demo-header"] == "ABC"
|
|
|
|
|
|
async def test_get_http_headers_excludes_content_type(sse_server: ASGIServer):
|
|
"""Test that get_http_headers() excludes content-type header (issue #3097).
|
|
|
|
This prevents HTTP 415 errors when forwarding headers to downstream APIs
|
|
that require specific Content-Type headers (e.g., application/vnd.api+json).
|
|
"""
|
|
from fastmcp.server.dependencies import get_http_headers
|
|
|
|
server = FastMCP()
|
|
|
|
@server.tool
|
|
def check_excluded_headers() -> dict[str, str]:
|
|
"""Check that problematic headers are excluded from get_http_headers()."""
|
|
return get_http_headers()
|
|
|
|
async with asgi_server(server, transport="sse") as running_server:
|
|
async with running_server.client(
|
|
headers={
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
"X-Custom-Header": "should-be-included",
|
|
}
|
|
) as client:
|
|
result = await client.call_tool("check_excluded_headers")
|
|
headers = result.data
|
|
|
|
# These headers should be excluded
|
|
assert "content-type" not in headers
|
|
assert "accept" not in headers
|
|
assert "host" not in headers
|
|
assert "content-length" not in headers
|
|
|
|
# Custom headers should be included
|
|
assert "x-custom-header" in headers
|
|
assert headers["x-custom-header"] == "should-be-included"
|
|
|
|
|
|
@pytest.mark.skip(reason="Phase 3: requires TasksExtension (SEP-2663 adapter)")
|
|
async def test_background_task_can_read_snapshotted_request_headers():
|
|
"""Background tools can still access request headers via get_http_request()."""
|
|
server = FastMCP()
|
|
|
|
@server.tool(task=True)
|
|
async def check_request_header() -> str:
|
|
request = get_http_request()
|
|
return request.headers.get("x-tenant-id", "missing")
|
|
|
|
async with asgi_server(server, transport="sse") as running_server:
|
|
async with running_server.client(
|
|
headers={"X-Tenant-ID": "tenant-123"}
|
|
) as client:
|
|
task = await client.call_tool("check_request_header", task=True)
|
|
result = await task.result()
|
|
assert result.data == "tenant-123"
|
|
|
|
|
|
@pytest.mark.skip(reason="Phase 3: requires TasksExtension (SEP-2663 adapter)")
|
|
async def test_background_task_current_http_dependencies_restore_headers():
|
|
"""CurrentHeaders/CurrentRequest work in task workers without explicit Context."""
|
|
server = FastMCP()
|
|
|
|
@server.tool(task=True)
|
|
async def check_headers(
|
|
headers: dict[str, str] = CurrentHeaders(),
|
|
request: Request = CurrentRequest(),
|
|
) -> dict[str, str]:
|
|
return {
|
|
"authorization": headers.get("authorization", "missing"),
|
|
"tenant": request.headers.get("x-tenant-id", "missing"),
|
|
}
|
|
|
|
async with asgi_server(server, transport="sse") as running_server:
|
|
async with running_server.client(
|
|
headers={
|
|
"Authorization": "Bearer tenant-token",
|
|
"X-Tenant-ID": "tenant-456",
|
|
}
|
|
) as client:
|
|
task = await client.call_tool("check_headers", task=True)
|
|
result = await task.result()
|
|
assert result.data == {
|
|
"authorization": "Bearer tenant-token",
|
|
"tenant": "tenant-456",
|
|
}
|