+ Q(i1Rt^RIHt^RIt^RIt^RIHt^RIHtH t H t H t H t ^RI Ht^RIt^RIHtHtHtHtHt^RIHtHt^RIHt^R IHt]'d^R IHtHtH t H!t!^R I"H#t#R R lt$!RR]4t%!RR]4t&!RR]%]&4t'!RR]4t(!RR]%](4t)]']),t*]&](,t+]*]+,t,!RR]4t-!RR]-4t.RRlt/R#)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 SSETransportStdioTransportStreamableHttpTransport)FastMCPc V^8dQhRRRR/#)urlz str | AnyUrlreturnzLiteral['http', 'sse'])formats"X/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/fastmcp/mcp_config.py __annotate__r8s c\V4pVPR4'g\RV 24h\V4pVPp\ P !RV4'dR#R#)z: Infer the appropriate transport type from the given URL. httpz Invalid URL: z/sse(/|\?|&|$)sse)str startswith ValueErrorr pathresearch)r parsed_urlr's& rinfer_transport_type_from_urlr+8sZ c(C >>& ! !=.//#J ??D yy"D))r ca]tRt^Lt$Rt]!]R7tR]R&]!RRR7t R]R &]!RR R7t R]R &] !R R 7] RRl44t RRV3RllltRRltRtV;t#)_TransformingMCPServerMixinzAA mixin that enables wrapping an MCP Server with tool transforms.default_factoryzdict[str, ToolTransformConfig]toolsNz!The tags to include in the proxy.)default descriptionzset[str] | None include_tagsz!The tags to exclude in the proxy. exclude_tagsbeforemodec V^8dQhRRRR/#rvaluesdict[str, Any]rr)rs"rr(_TransformingMCPServerMixin.__annotate__^s# r c \V\4'dd\VPR44pVPR4RJpVPR4RJpV'gV'gV'g \ R4hV#)zReject if none of the transforming fields are set. This ensures that plain server configs (without tools, include_tags, or exclude_tags) fall through to the base server types during union validation, avoiding unnecessary proxy wrapping. r0r3Nr4zFAt least one of 'tools', 'include_tags', or 'exclude_tags' is required) isinstancedictboolgetr&)clsr: has_tools has_include has_excludes&& r%_require_at_least_one_transform_fieldA_TransformingMCPServerMixin._require_at_least_one_transform_field\sh fd # #VZZ01I **^4D@K **^4D@K  \ r c$V^8dQhRRRRRR/#)r server_name str | None client_namerz$tuple[FastMCP[Any], ClientTransport]r)rs"rrr<qs(!-!-!- !- . !-r c <^RIHp^RIHp^RIHp\ S V`4p\WF4pV!WbR7pV!VVR7pVPeVPVPRR7VPeVPVPR7VP'd(^R IHp VP!V !VP44W3#) z_Turn the Transforming MCPServer into a FastMCP Server and also return the underlying transport.)Client)r) create_proxy) transportname)rPT)tagsonly)rQ) ToolTransform)fastmcp.clientrMfastmcp.client.transportsrfastmcp.serverrNsuper to_transportrr3enabler4disabler0fastmcp.server.transformsrS add_transform) selfrIrKrMrrNrOclientwrapped_mcp_serverrS __class__s &&& r#_to_server_and_underlying_transport?_TransformingMCPServerMixin._to_server_and_underlying_transportqs *  0%*W%9%; 4 *09*W)      (  % %4+<+<4 % H    (  & &D,=,= & > ::: ?  , ,]4::-F G!,,r cV^8dQhRR/#)rrrr)rs"rrr<sSSoSr c J^RIHpV!VP4^,R7#)z2Get the transport for the transforming MCP server.)FastMCPTransport)mcp)rUrera)r]res& rrX(_TransformingMCPServerMixin.to_transports>D$L$L$Nq$QRRr r)NN)__name__ __module__ __qualname____firstlineno____doc__r r?r0__annotations__r3r4r classmethodrFrarX__static_attributes__ __classcell__)r`s@rr-r-LsK,1$,GE )G9$)7%L/ %*7%L/ (#$&!-!-FSSr r-c]tRt^t$RtR]R&]!]R7tR]R&]!] R7t R]R&R t R ]R &R t R ]R&R t R]R&R tR]R&R tR]R&R tR]R&R tR]R&R tR]R&]!RR7tRRltRtR #)StdioMCPServerzMCP server configuration for stdio transport. This is the canonical configuration format for MCP servers using stdio transport. r$commandr.z list[str]argsr;envstdiozLiteral['stdio']rONzLiteral['stdio'] | NonetyperJcwd int | Nonetimeoutz bool | None keep_aliver2icondict[str, Any] | NoneauthenticationallowextracV^8dQhRR/#)rrrr)rs"rrStdioMCPServer.__annotate__s   n  r c ^RIHpV!VPVPVPVP VP R7#))r)rsrtrurxr{)rUrrsrtrurxr{)r]rs& rrXStdioMCPServer.to_transports5<LL   r r)rhrirjrkrlrmr listrtr?rurOrwrxrzr{r2r|r~r model_configrXrorr rrrrrs LD1D)15C5#*I)$(D !(CGZ   #K"D*-1N)0G,L   r rrc]tRt^tRtRtR#)TransformingStdioMCPServerz$A Stdio server with tool transforms.rNrhrirjrkrlrorr rrrs.r rc]tRt^t$RtR]R&RtR]R&]!]R7t R]R &Rt R ]R &Rt R ]R &Rt R]R&Rt R]R&RtR]R&RtR]R&]!RRR7tRRltRtR#)RemoteMCPServerzMCP server configuration for HTTP/SSE transport. This is the canonical configuration format for MCP servers using remote transports. r$rNz0Literal['http', 'streamable-http', 'sse'] | NonerOr.zdict[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_timeoutryrzrJr2r|r}r~rT)rarbitrary_types_allowedcV^8dQhRR/#)rrz&StreamableHttpTransport | SSETransportr)rs"rrRemoteMCPServer.__annotate__sDr c P^RIHpHpVPf\ VP 4pM VPpVR8Xd5V!VP VP VPVPR7#V!VP VP VPVPR7#)r)rrr#)rrr) rUrrrOr+rrrr)r]rrrOs& rrXRemoteMCPServer.to_transportsS >> !5dhh?II   YY!%!6!6  + YY!%!6!6  r r)rhrirjrkrlrmrOr r?rrrrzr2r|r~r rrXrorr rrrs HCGI?F#D9G^9    AE=DGZ#K"D*-1N)0tLr rc]tRtRtRtRtR#)TransformingRemoteMCPServeri z%A Remote server with tool transforms.rNrrr rrr s/r rc]tRtRt$Rt]!]R7tR]R&] !RR7t ] !RR 7] R R l44t R R lt] RRl4tRRltRRlt] RRl4tRtR#) MCPConfigia(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. r.zdict[str, MCPServerTypes] mcpServersrrr5r6c V^8dQhRRRR/#r9r)rs"rrMCPConfig.__annotate__"s  . ^ r c RV9d]\;QJd*RVP44F 'gK RM RM!RVP444pV'dRV/#V#)zMIf there's no mcpServers key but there are server configs at root, wrap them.rc3v"TF/p\V\4;'dRV9;'gRV9xK1 R#5i)rsrN)r>r?).0vs& r 1MCPConfig.wrap_servers_at_root..&s9(A1d#FFa)E)E5A:F(s 9 99TF)anyr:)rBr: has_serverss&& rwrap_servers_at_rootMCPConfig.wrap_servers_at_root sY v %####K$f-- r c$V^8dQhRRRRRR/#)rrPr$serverMCPServerTypesrNoner)rs"rrr/s!''s'N't'r c "W PV&R#z,Add or update a server in the configuration.Nrr]rPrs&&&r add_serverMCPConfig.add_server/s &r c V^8dQhRRRR/#)rconfigr;rrr)rs"rrr4s**~*$*r c $VPV4#)z/Parse MCP configuration from dictionary format.)model_validate)rBrs&&r from_dictMCPConfig.from_dict3s!!&))r cV^8dQhRR/#)rrr;r)rs"rrr8s222r c &VPRR7#)z>Convert MCPConfig to dictionary format, preserving all fields.T exclude_none) model_dump)r]s&rto_dictMCPConfig.to_dict8sD11r c V^8dQhRRRR/#)r file_pathrrrr)rs"rrr<s==t==r c VPPRRR7VPVP^R74R#)z!Write configuration to JSON file.T)parentsexist_ok)indentN)parentmkdir write_textmodel_dump_json)r]rs&&r write_to_fileMCPConfig.write_to_file<s7td;T111;&445R 5R5RS +5+5 #r )0rl __future__rdatetimer(pathlibrtypingrrrrr urllib.parser httpxpydanticr r r r rtyping_extensionsrrfastmcp.tools.tool_transformrfastmcp.utilities.typesrrUrrrrfastmcp.server.serverrr+r-rrrrrTransformingMCPServerTypesrrrrrrr rrs0# ??! -<4 .(LS"2LS^* Y* Z/!