π The fast, Pythonic way to build MCP servers and clients.
fix: substitute server variable defaults when building base URL from OpenAPI spec (#3770)
Rishav Mitra99eaeb8af458
diff --git a/src/fastmcp/server/providers/openapi/provider.py b/src/fastmcp/server/providers/openapi/provider.pyindex bc826d1df..dd9a73559 100644--- a/src/fastmcp/server/providers/openapi/provider.py+++ b/src/fastmcp/server/providers/openapi/provider.py@@ -175,6 +175,9 @@ class OpenAPIProvider(Provider):"entry to the spec or provide an httpx.AsyncClient explicitly.")base_url = servers[0]["url"]+ variables = servers[0].get("variables", {})+ for name, var in variables.items():+ base_url = base_url.replace(f"{{{name}}}", var.get("default", ""))return httpx.AsyncClient(base_url=base_url, timeout=DEFAULT_TIMEOUT)@asynccontextmanagerdiff --git a/tests/server/providers/openapi/test_server.py b/tests/server/providers/openapi/test_server.pyindex 0d7447eab..af3641ca0 100644--- a/tests/server/providers/openapi/test_server.py+++ b/tests/server/providers/openapi/test_server.py@@ -9,6 +9,58 @@ from fastmcp.server.providers.openapi import OpenAPIProviderfrom fastmcp.server.providers.openapi.provider import DEFAULT_TIMEOUT+class TestOpenAPIProviderServerVariables:+ """Test that OpenAPIProvider resolves OpenAPI 3.x server variables."""++ def test_server_variables_substituted_with_defaults(self):+ spec = {+ "openapi": "3.0.0",+ "info": {"title": "Test API", "version": "1.0.0"},+ "servers": [+ {+ "url": "https://{region}.api.example.com/v1",+ "variables": {+ "region": {+ "default": "us",+ "enum": ["us", "eu", "apac"],+ }+ },+ }+ ],+ "paths": {},+ }+ client = OpenAPIProvider._create_default_client(spec)+ assert str(client.base_url) == "https://us.api.example.com/v1/"++ def test_multiple_server_variables_substituted(self):+ spec = {+ "openapi": "3.0.0",+ "info": {"title": "Test API", "version": "1.0.0"},+ "servers": [+ {+ "url": "{scheme}://{host}/v1",+ "variables": {+ "scheme": {"default": "https"},+ "host": {"default": "api.example.com"},+ },+ }+ ],+ "paths": {},+ }+ client = OpenAPIProvider._create_default_client(spec)+ assert str(client.base_url) == "https://api.example.com/v1/"++ def test_static_server_url_unaffected(self):+ spec = {+ "openapi": "3.0.0",+ "info": {"title": "Test API", "version": "1.0.0"},+ "servers": [{"url": "https://api.example.com"}],+ "paths": {},+ }+ client = OpenAPIProvider._create_default_client(spec)+ assert str(client.base_url) == "https://api.example.com"++class TestOpenAPIProviderBasicFunctionality:"""Test basic OpenAPIProvider functionality."""