π The fast, Pythonic way to build MCP servers and clients.
Handle AuthorizationError as exclusion in AuthMiddleware list hooks
Yang Geonheed7674b3c0cf0
diff --git a/src/fastmcp/server/middleware/authorization.py b/src/fastmcp/server/middleware/authorization.pyindex abe33447b..4d3914a18 100644--- a/src/fastmcp/server/middleware/authorization.py+++ b/src/fastmcp/server/middleware/authorization.py@@ -102,8 +102,11 @@ class AuthMiddleware(Middleware):authorized_tools: list[Tool] = []for tool in tools:ctx = AuthContext(token=token, component=tool)- if await run_auth_checks(self.auth, ctx):- authorized_tools.append(tool)+ try:+ if await run_auth_checks(self.auth, ctx):+ authorized_tools.append(tool)+ except AuthorizationError:+ continuereturn authorized_tools@@ -169,8 +172,11 @@ class AuthMiddleware(Middleware):authorized_resources: list[Resource] = []for resource in resources:ctx = AuthContext(token=token, component=resource)- if await run_auth_checks(self.auth, ctx):- authorized_resources.append(resource)+ try:+ if await run_auth_checks(self.auth, ctx):+ authorized_resources.append(resource)+ except AuthorizationError:+ continuereturn authorized_resources@@ -238,8 +244,11 @@ class AuthMiddleware(Middleware):authorized_templates: list[ResourceTemplate] = []for template in templates:ctx = AuthContext(token=token, component=template)- if await run_auth_checks(self.auth, ctx):- authorized_templates.append(template)+ try:+ if await run_auth_checks(self.auth, ctx):+ authorized_templates.append(template)+ except AuthorizationError:+ continuereturn authorized_templates@@ -262,8 +271,11 @@ class AuthMiddleware(Middleware):authorized_prompts: list[Prompt] = []for prompt in prompts:ctx = AuthContext(token=token, component=prompt)- if await run_auth_checks(self.auth, ctx):- authorized_prompts.append(prompt)+ try:+ if await run_auth_checks(self.auth, ctx):+ authorized_prompts.append(prompt)+ except AuthorizationError:+ continuereturn authorized_promptsdiff --git a/tests/server/auth/test_authorization.py b/tests/server/auth/test_authorization.pyindex 4bd0dff9a..f6e86aeef 100644--- a/tests/server/auth/test_authorization.py+++ b/tests/server/auth/test_authorization.py@@ -9,6 +9,7 @@ from mcp.server.auth.middleware.bearer_auth import AuthenticatedUserfrom fastmcp import FastMCPfrom fastmcp.client import Client+from fastmcp.exceptions import AuthorizationErrorfrom fastmcp.server.auth import (AccessToken,AuthContext,@@ -156,7 +157,6 @@ class TestRunAuthChecks:async def test_authorization_error_propagates(self):"""AuthorizationError from auth check should propagate with custom message."""- from fastmcp.exceptions import AuthorizationErrordef custom_auth_check(ctx: AuthContext) -> bool:raise AuthorizationError("Custom denial reason")@@ -177,8 +177,6 @@ class TestRunAuthChecks:async def test_authorization_error_stops_chain(self):"""AuthorizationError should stop the check chain and propagate."""- from fastmcp.exceptions import AuthorizationError-call_order = []def check_1(ctx: AuthContext) -> bool:@@ -242,7 +240,6 @@ class TestRunAuthChecks:async def test_async_check_authorization_error_propagates(self):"""Async checks that raise AuthorizationError should propagate."""- from fastmcp.exceptions import AuthorizationErrorasync def async_denial(ctx: AuthContext) -> bool:raise AuthorizationError("Async denial")@@ -456,6 +453,88 @@ class TestAuthMiddleware:finally:auth_context_var.reset(tok)+ async def test_middleware_skips_tool_on_authorization_error(self):+ def deny_blocked_tool(ctx: AuthContext) -> bool:+ if ctx.component.name == "blocked_tool":+ raise AuthorizationError(f"deny {ctx.component.name}")+ return True++ mcp = FastMCP(middleware=[AuthMiddleware(auth=deny_blocked_tool)])++ @mcp.tool+ def blocked_tool() -> str:+ return "blocked"++ @mcp.tool+ def allowed_tool() -> str:+ return "allowed"++ result = await mcp._list_tools_mcp(mcp_types.ListToolsRequest())+ assert [tool.name for tool in result.tools] == ["allowed_tool"]++ async def test_middleware_skips_resource_on_authorization_error(self):+ def deny_blocked_resource(ctx: AuthContext) -> bool:+ if ctx.component.name == "blocked_resource":+ raise AuthorizationError(f"deny {ctx.component.name}")+ return True++ mcp = FastMCP(middleware=[AuthMiddleware(auth=deny_blocked_resource)])++ @mcp.resource("resource://blocked")+ def blocked_resource() -> str:+ return "blocked"++ @mcp.resource("resource://allowed")+ def allowed_resource() -> str:+ return "allowed"++ result = await mcp._list_resources_mcp(mcp_types.ListResourcesRequest())+ assert [str(resource.uri) for resource in result.resources] == [+ "resource://allowed"+ ]++ async def test_middleware_skips_resource_template_on_authorization_error(self):+ def deny_blocked_resource_template(ctx: AuthContext) -> bool:+ if ctx.component.name == "blocked_resource_template":+ raise AuthorizationError(f"deny {ctx.component.name}")+ return True++ mcp = FastMCP(middleware=[AuthMiddleware(auth=deny_blocked_resource_template)])++ @mcp.resource("resource://blocked/{item}")+ def blocked_resource_template(item: str) -> str:+ return item++ @mcp.resource("resource://allowed/{item}")+ def allowed_resource_template(item: str) -> str:+ return item++ result = await mcp._list_resource_templates_mcp(+ mcp_types.ListResourceTemplatesRequest()+ )+ assert [template.uriTemplate for template in result.resourceTemplates] == [+ "resource://allowed/{item}"+ ]++ async def test_middleware_skips_prompt_on_authorization_error(self):+ def deny_blocked_prompt(ctx: AuthContext) -> bool:+ if ctx.component.name == "blocked_prompt":+ raise AuthorizationError(f"deny {ctx.component.name}")+ return True++ mcp = FastMCP(middleware=[AuthMiddleware(auth=deny_blocked_prompt)])++ @mcp.prompt+ def blocked_prompt() -> str:+ return "blocked"++ @mcp.prompt+ def allowed_prompt() -> str:+ return "allowed"++ result = await mcp._list_prompts_mcp(mcp_types.ListPromptsRequest())+ assert [prompt.name for prompt in result.prompts] == ["allowed_prompt"]+# =============================================================================# Integration tests with Client