k7ia,SrSSKJr SSKrSSKrSSKJr SSKJrJ r J r J r J r SSK Jr SSKrSSKJrJrJrJrJr SSKJrJr SS KJr SS KJr \(aSS KJrJrJ r J!r! SS K"J#r# SS jr$"SS\5r%"SS\5r&"SS\%\&5r'"SS\5r("SS\%\(5r)\'\)-r*\&\(-r+\*\+-r,"SS\5r-"SS\-5r.SSjr/g)aCanonical MCP Configuration Format. This module defines the standard configuration format for Model Context Protocol (MCP) servers. It provides a client-agnostic, extensible format that can be used across all MCP implementations. The configuration format supports both stdio and remote (HTTP/SSE) transports, with comprehensive field definitions for server metadata, authentication, and execution parameters. Example configuration: ```json { "mcpServers": { "my-server": { "command": "npx", "args": ["-y", "@my/mcp-server"], "env": {"API_KEY": "secret"}, "timeout": 30000, "description": "My MCP server" } } } ``` ) annotationsN)Path) TYPE_CHECKING AnnotatedAnyLiteralcast)urlparse)AnyUrl BaseModel ConfigDictFieldmodel_validator)Selfoverride)ToolTransformConfig)FastMCPBaseModel)ClientTransport SSETransportStdioTransportStreamableHttpTransportFastMCPc[U5nURS5(d[SU35e[U5nURn[ R "SU5(agg)z: Infer the appropriate transport type from the given URL. httpz Invalid URL: z/sse(/|\?|&|$)sse)str startswith ValueErrorr pathresearch)url parsed_urlr s L/home/james-whalen/.local/lib/python3.13/site-packages/fastmcp/mcp_config.pyinfer_transport_type_from_urlr&8sZ c(C >>& ! !=.//#J ??D yy"D))c^\rSrSr%Sr\"S5rS\S'\"SSS9rS \S '\"SS S9r S \S 'SSU4S jjjr SSjr Sr U=r $)_TransformingMCPServerMixinLzAA mixin that enables wrapping an MCP Server with tool transforms..zdict[str, ToolTransformConfig]toolsNz!The tags to include in the proxy.)default descriptionzset[str] | None include_tagsz!The tags to exclude in the proxy. exclude_tagsc>SSKJn SSKJn SSKJn [ T U]5n[XV5nU"XbS9nUR"UUURURURS9nX4$)z_Turn the Transforming MCPServer into a FastMCP Server and also return the underlying transport.rr)Client)r) transportname)r3backendtool_transformationsr.r/) fastmcprfastmcp.clientr1fastmcp.client.transportsrsuper to_transportr as_proxyr+r.r/) self server_name client_namerr1rr2clientwrapped_mcp_server __class__s r%#_to_server_and_underlying_transport?_TransformingMCPServerMixin._to_server_and_underlying_transport\sn $) &+W%9%; 4 *09*W$--!%****  ",,r'c<SSKJn U"UR5SS9$)z2Get the transport for the transforming MCP server.r)FastMCPTransport)mcp)r8rErB)r<rEs r%r:(_TransformingMCPServerMixin.to_transportws>D$L$L$Nq$QRRr')NN)r= str | Noner>rIreturnz$tuple[FastMCP[Any], ClientTransport])rJr)__name__ __module__ __qualname____firstlineno____doc__rr+__annotations__r.r/rBr:__static_attributes__ __classcell__)rAs@r%r)r)LsK,1#JE )69$)7%L/ %*7%L/#'"&-- - . --6SSr'r)c\rSrSr%SrS\S'\"\S9rS\S'\"\ S9r S\S 'S r S \S 'S r S\S'S r S\S'S rS\S'S rS\S'S rS\S'S rS\S'\"SS9rSSjrSrg )StdioMCPServer~zMCP server configuration for stdio transport. This is the canonical configuration format for MCP servers using stdio transport. rcommanddefault_factoryz list[str]argsdict[str, Any]envstdiozLiteral['stdio']r2NzLiteral['stdio'] | NonetyperIcwd int | Nonetimeoutr-icondict[str, Any] | NoneauthenticationallowextracpSSKJn U"URURURUR S9$)Nr)r)rVrYr[r^)r8rrVrYr[r^)r<rs r%r:StdioMCPServer.to_transports.<LL   r'rH)rJr)rKrLrMrNrOrPrlistrYdictr[r2r]r^r`r-rarcr model_configr:rQrHr'r%rTrT~s LD1D)15C5#*I)$(D !(CGZ#K"D*-1N)0G,L r'rTc\rSrSrSrSrg)TransformingStdioMCPServerz$A Stdio server with tool transforms.rHNrKrLrMrNrOrQrHr'r%rmrms.r'rmc\rSrSr%SrS\S'SrS\S'\"\S9r S \S 'Sr S \S 'Sr S \S'Sr S\S'Sr S\S'SrS\S'SrS\S'\"SSS9rSSjrSrg)RemoteMCPServerzMCP server configuration for HTTP/SSE transport. This is the canonical configuration format for MCP servers using remote transports. rr#Nz0Literal['http', 'streamable-http', 'sse'] | Noner2rWzdict[str, str]headerszAnnotated[str | Literal['oauth'] | httpx.Auth | None, Field(description='Either a string representing a Bearer token, the literal "oauth" to use OAuth authentication, or an httpx.Auth instance for custom authentication.')]authz'datetime.timedelta | int | float | Nonesse_read_timeoutr_r`rIr-rarbrcrdT)rfarbitrary_types_allowedc@SSKJnJn URc[ UR 5nO URnUS:Xa1U"UR UR URURS9$U"UR UR URURS9$)Nr)rrr)rsrtru) r8rrr2r&r#rsrtru)r<rrr2s r%r:RemoteMCPServer.to_transportsS >> !5dhh?II   YY!%!6!6  + YY!%!6!6  r'rH)rJz&StreamableHttpTransport | SSETransport)rKrLrMrNrOrPr2rrjrsrtrur`r-rarcr rkr:rQrHr'r%rqrqs HCGI?F#D9G^9    AE=DGZ#K"D*-1N)0tLr'rqc\rSrSrSrSrg)TransformingRemoteMCPServerz%A Remote server with tool transforms.rHNrorHr'r%rzrzs/r'rzc\rSrSr%Sr\"\S9rS\S'\ "SS9r \ "SS 9\ SS j55r SS jr\ SS j5rSS jrSSjr\ SSj5rSrg) MCPConfiga(A configuration object for MCP Servers that conforms to the canonical MCP configuration format while adding additional fields for enabling FastMCP-specific features like tool transformations and filtering by tags. For an MCPConfig that is strictly canonical, see the `CanonicalMCPConfig` class. rWzdict[str, MCPServerTypes] mcpServersrdrebefore)modechSU;a+[SUR555nU(aSU0$U$)zMIf there's no mcpServers key but there are server configs at root, wrap them.rc3r# UH-n[U[5=(a SU;=(d SU;v M/ g7f)rVr#N) isinstancerj).0vs r% 1MCPConfig.wrap_servers_at_root..s3(A1d#Fa)E5A:F(s57)anyvalues)clsr has_serverss r%wrap_servers_at_rootMCPConfig.wrap_servers_at_roots> v %K$f-- r'c X RU'gz,Add or update a server in the configuration.Nrr<r3servers r% add_serverMCPConfig.add_servers &r'c$URU5$)z/Parse MCP configuration from dictionary format.)model_validate)rconfigs r% from_dictMCPConfig.from_dicts!!&))r'c URSS9$)z>Convert MCPConfig to dictionary format, preserving all fields.T exclude_none) model_dump)r<s r%to_dictMCPConfig.to_dictsD11r'ctURRSSS9 URURSS95 g)z!Write configuration to JSON file.T)parentsexist_ok)indentN)parentmkdir write_textmodel_dump_json)r< file_paths r% write_to_fileMCPConfig.write_to_files7td;T111;&445R 5R5RS +5+5 #r')r#z str | AnyUrlrJzLiteral['http', 'sse'])rrr=rrrrJr)0rO __future__rdatetimer!pathlibrtypingrrrrr urllib.parser httpxpydanticr r r rrtyping_extensionsrrfastmcp.tools.tool_transformrfastmcp.utilities.typesrr8rrrrfastmcp.server.serverrr&r)rTrmrqrzTransformingMCPServerTypesrrr}rrrHr'r%rs0# ??! -<4 . (/S"2/Sd& Y& R/!