k7i\SrSSKJr SSKrSSKrSSKrSSKrSSKJr SSK J r SSK J r J r SSKJr SSKJrJrJr SSKrSS KJr SS KJr SSKrSS KJr SS KJrJr SS KJr SSK J!r! SSK"J#r#J$r$ SSK%J&r& SSK'J(r( SSK)J*r*J+r+J,r,J-r-J.r.J/r/ \(aSSK0J1r1 \("\25r3\Sr4S*Sjr5\ \*S/S4r6\ \*S/S4r7"SS\Rp5r9"SS\Rp5r:\ "SS9"SS55r;\;"\9RxS 9/r=S+S!jr>"S"S#\#5r?"S$S%\5r@"S&S'\5rA"S(S)\!5rBg),z6FastMCP server implementation for OpenAPI integration.) annotationsN)Counter)Callable) dataclassfield)Pattern) TYPE_CHECKINGAnyLiteral)ToolAnnotations)AnyUrl) ToolError)ResourceResourceTemplate)get_http_headers)FastMCP)Tool ToolResult)openapi) get_logger) HTTPRoute_combine_schemas$extract_output_schema_from_responsesformat_array_parameterformat_deep_object_parameter!format_description_with_responses)Context)GETPOSTPUTPATCHDELETEOPTIONSHEADcU(dg[R"SSU5n[R"SSU5n[R"SSU5nURS5nU$)z Convert text to a URL-friendly slug format that only contains lowercase letters, uppercase letters, numbers, and underscores. z [\s\-\.]+_z [^a-zA-Z0-9_]z_+)resubstrip)textslugs P/home/james-whalen/.local/lib/python3.13/site-packages/fastmcp/server/openapi.py_slugifyr.,s[  66,T *D 66"B -D 66%d #D ::c?D KMCPTypeMCPType | Nonez7OpenAPITool | OpenAPIResource | OpenAPIResourceTemplatec(\rSrSrSrSrSrSrSrSr g) r0NaType of FastMCP component to create from a route. Enum values: TOOL: Convert the route to a callable Tool RESOURCE: Convert the route to a Resource (typically GET endpoints) RESOURCE_TEMPLATE: Convert the route to a ResourceTemplate (typically GET with path params) EXCLUDE: Exclude the route from being converted to any MCP component IGNORE: Deprecated, use EXCLUDE instead TOOLRESOURCERESOURCE_TEMPLATEEXCLUDEN) __name__ __module__ __qualname____firstlineno____doc__r4r5r6r7__static_attributes__r8r/r-r0r0Ns DH+Gr/c(\rSrSrSrSrSrSrSrSr g) RouteTypeazy Deprecated: Use MCPType instead. This enum is kept for backward compatibility and will be removed in a future version. r4r5r6IGNOREr8N) r9r:r;r<r=r4r5r6rBr>r8r/r-r@r@as DH+ Fr/r@T)kw_onlyc\rSrSr%Sr\"SS9rS\S'\"SS9rS\S '\"S S9r S \S '\"\ S S0S9r S\S'\"S S S0S9r S\S'\"\ S S0S9r S\S'SrSrg )RouteMapnzAMapping configuration for HTTP routes to FastMCP component types.*)defaultzlist[HttpMethod] | Literal['*']methodsz.*zPattern[str] | strpatternNzRouteType | MCPType | None route_type descriptionz,A set of tags to match. All tags must match.)default_factorymetadataset[str]tagsz(The type of FastMCP component to create.)rHrNr1mcp_typez:A set of tags to apply to the generated FastMCP component.mcp_tagscDURGc[URGbM[RR(a[ R "S[SS9 [UR[5(a9[RR(a[ R "S[SS9 UR[R:Xa9[RR(a[ R "S[SS9 [UR[5(a4URRnUS:XaSn[[U5UlO*URUlOURc [S 5eURcURUlgg) z8Validate and process the route map after initialization.NzThe 'route_type' parameter is deprecated and will be removed in a future version. Use 'mcp_type' instead with the appropriate MCPType value.) stacklevelz_The RouteType class is deprecated and will be removed in a future version. Use MCPType instead.zdRouteType.IGNORE is deprecated and will be removed in a future version. Use MCPType.EXCLUDE instead.rBr7z`mcp_type` must be provided)rQrKfastmcpsettingsdeprecation_warningswarningswarnDeprecationWarning isinstancer@rBnamegetattrr0 ValueError)selfroute_type_names r- __post_init__RouteMap.__post_init__s+ == T__%@44 Q&  $//955##88MM/*#$ )"2"22##88MM7*#$ $//955"&//"6"6"h.&/O ' A $ ]] ":; ; ?? ""mmDO #r/)rQrK)r9r:r;r<r=rrI__annotations__rJrKsetrPrQrRrbr>r8r/r-rErEnsK/4S/AG ,A"'"6G 6-24-@J*@!OPD( %!KL Hn W Hh*,r/rErQc UGHPnURS:XdURUR;dM0[UR[5(a&URR UR 5nO+[R "URUR 5nU(dMUR(a@[UR=(d /5nURRU5(dMURce[RSURSUR SURR35 Us $ [[ R"S9$)a  Determines the FastMCP component type based on the route and mappings. Args: route: HTTPRoute object mappings: List of RouteMap objects in priority order Returns: The RouteMap that matches the route, or a catchall "Tool" RouteMap if no match is found. rGRoute  z matched mapping to rf)rImethodr\rJrsearchpathr(rPreissubsetrQloggerdebugr]rEr0r4)routemappings route_mappattern_matchesroute_tags_sets r-_determine_route_typerus    #u||y7H7H'H)++W55"+"3"3":":5::"F"$))I,=,=uzz"J>>%()9r%:N$>>22>BB !))555 U\\N!EJJ<7KIL^L^LcLcKde! 16 W\\ **r/cx^\rSrSrSrSSU4SjjjrS SjrS SjrSrU=r $) OpenAPIToolz*Tool implementation for OpenAPI endpoints.c r>[T U]UUUUU=(d [5U U S9 XlX lXlg)N)r]rL parameters output_schemarPr serializer)super__init__re_client_route_timeout) r`clientrpr]rLrzr{rPtimeoutrr| __class__s r-r~OpenAPITool.__init__sC #!'#!     r/cSUR<SURRSURRS3$)@Custom representation to prevent recursion errors when printing.zOpenAPITool(name=z , method=, path=))r]rrjrlr`s r-__repr__OpenAPITool.__repr__s;"499-y9K9K8LGTXT_T_TdTdSeefggr/c ^'# 0n[5nURR(aURRR(a~[ [ URRR55nURRRUn[UR S05R55nURRHXnURnURSUR3nURU;aXvR4X('XvR4X''MZ URRn 0n URRHn U RS:XdMU RSU R3nX;a$UR U5bXXR'MYU RU;dMkUR U R5cMXRXR'M URRV s1sH4n U RS:XdMU R(dM(U RiM6 n n XR5- n U (a[SU 35eU R5Hum'n[ U'4SjURR5S5nU(ah[U[ 5(aSUR"nUR S5S:HnU(a,[%UT'S S 9nU R'S T'S 3[)U55n MU R'S T'S 3[)U55n M 0nURRGHXn U RS :XdMU RSU R3nSnUR U5nX;a9Ub6US:wa0[U[ [*-5(a[-U5S:XdXnOmUR U R5nU RU;aBUb?US:wa9[U[ [*-5(a[-U5S:XdXRnUcMU R.=(d SnU R0b U R0OSnUS:Xa[U[*5(a[-U5S:ayU(a)[3XR5nUR5U5 GM~[6R9SU RS35 [:R<"U5UU R'GM[U[ 5(amU R"R S5S:XaN[-U5S:a?U(aUUU R'GM#[%XRSS 9nUUU R'GMIUUU R'GM[ 0n0nURRHn U RS:XdMU RSU R3nSnX;aUR U5bXnO:U RU;a*UR U R5bXRnUcM[)U5UU RR?5'M UR5U5 [A5nUR5U5 SnURR(aURRR(a[5nURRHZn U RU;a,URCU RSU R35 M?URCU R5 M\ UR5VVs0sHunnUU;dMUU_M n nnU (aU nURDRGURRHU UUUURJS9IShvN n!U!RM5 U!R;5n"Sn#URNb(URNR S5(aSU"0n#OU"n#O[U"[*5(dSU"0n#OU"n#[QU#S9$s sn fs snnfN![:RRa [QU!RTS9s$f=f![VRXan$SU$RZR\SU$RZR^3n%U$RZR;5n&U%SU&3- n%OW![:RR[`4a: U$RZRT(aU%SU$RZRT3- n%Of=f[aU%5U$eSn$A$f[VRban$[aSU$<35U$eSn$A$ff=f7f)z:Execute the HTTP request based on the route configuration. properties__rlNz"Missing required path parameters: c3J># UHoRT:XdMUv M g7fN)r]).0p param_names r- "OpenAPITool.run..?sK2qff 6J2s# #typearrayF)is_query_parameter{}queryr&rformT deepObjectz3deepObject style with explode=false for parameter 'z5' is not standard. Using JSON serialization fallback.header)rjurlparamsheadersjsonrzx-fastmcp-wrap-resultresult)structured_content)content HTTP error :  - Request error: )2rer request_bodycontent_schemanextitergetkeysrzr]locationrlrequiredritemsr\listschema_rreplacestrdictlenstyleexploderupdaternwarningrdumpslowerraddrrequestrjrraise_for_statusr{rJSONDecodeErrorr+httpxHTTPStatusErrorresponse status_code reason_phraser_ RequestError)(r` arguments param_mapping body_props content_type body_schemaparam original_name suffixed_namerl path_paramsrrequired_path_paramsmissing_params param_value param_infoschemais_arrayformatted_value query_paramssuffixed_value name_value param_style param_explodedeep_obj_paramsropenapi_headers mcp_headers json_dataparams_to_excludekv body_paramsrrstructured_outpute error_message error_datars( @r-runOpenAPITool.runsa  U ;; # # (@(@(O(OT[[%=%=%L%L MNL++22AA,OK[__\2>CCEFJ[[++E!JJM$zzl"U^^,<=MzzZ'0=~~/N ,,9>>+JM (,{{ ''AzzV##$66("QZZL 9 !.! m4@*3*BK'VVy(Y]]166-B-N*3FF*;K'([[++ +zzV# ()  AFF+  .0@0@0BB @@PQR R'2'8'8': #J KDKK22KTJjd;;#++!::f-8'=#ZE'O <<"ZL(;S=QRD<<"ZL 3S5EFD-(;2 ''AzzW$#$66("QZZL 9 " !*}!=!.&2&",">4$;??/14#,":K!*qvv!6J)+&2&",&z4$;??C OWXDX'0&7 *)6 &'YY%: " $|3&{D99 ,q0(/K +VV/O)//@#NN"UVWV\V\U]^E!F48::k3JL0#;55IIMM&1W< ,q0(4?L0/E +VV/O4CL00; QVV,Y(^''AzzX%#$66("QZZL 9 " ".! m4@"+":KVVy(Y]]166-B-N"+FF"3K*69+6FOAFFLLN3( ''( {# ;; # # (@(@(O(O!$ [[++FFj(%))QVVHBqzzl*CD%))!&&1 ,"+!2!2Aa?P6P1!2 ' 3 =!\\11{{))# 2H  % % ' 9!%)!%%1))--.EFF-5v,>),2)#FD11)16(:%(.%!5FGGE v>'' 9!(--88 9$$ 3ajj445R 8P8P7QR  =ZZ__. 3zl!33 ((*5 =::??!s1::??*;%< __classcell__rs@r-rwrws404 $ $.226 ! !     #  -   , 0  4hB=B=r/rwcl^\rSrSrSrSSU4SjjjrS SjrS SjrSrU=r $) OpenAPIResourcei z.Resource implementation for OpenAPI endpoints.c x>Uc [5n[T U] [U5UUUUS9 XlX lXlg)N)urir]rL mime_typerP)rer}r~r rrr) r`rrprr]rLrrPrrs r-r~OpenAPIResource.__init__sG <5D s #     r/cnSUR<SUR<SURRS3$)rzOpenAPIResource(name=z, uri=rr)r]rrrlrs r-rOpenAPIResource.__repr__&s1&tyym6$((WT[[M]M]L^^_``r/c^# URRn[UR5nSU;aSU;aUR S5n[ U5S:a0n[ R"SU5nU(aDURSS9 [ U5S- n[U5HupxXv:dM USU- n XU'M UR5H$upURSUS3[U 55nM& 0n URRHin U RS :XdM[US U R35(dM5[!US U R35n U cMSU S :wdM[XU R'Mk 0n [#5nU R%U5 UR&R)URR*UU U UR,S 9IS hvN nUR/5 UR0R3SS 5R55mST;a&UR75n[6R8"U5$[;U4SjS55(a UR<$UR>$N![@RBanSURDRFSURDRH3nURDR75nUSU3- nOW![6RJ[L4a: URDR<(aUSURDR<3- nOf=f[MU5UeS nAf[@RNan[MSU<35UeS nAff=f7f)z2Fetch the resource data by making an HTTP request.rr/z \{([^}]+)\}T)reverserr'Nr&)rjrrrrz content-typeapplication/jsonc3,># UH oT;v M g7frr8)rctrs r-r'OpenAPIResource.read..lsO2NB<'2Ns)ztext/zapplication/xmlrrrr)(rrlrrsplitrr(findallsort enumeraterrrzrhasattrr]r^rrrrrjrrrrrrranyr+rrrrrrrr_r)r`rl resource_uripartsr param_matchesexpected_param_countirrrrvaluerrrrrrrrs @r-readOpenAPIResource.read*sU =;;##Dtxx=Ld{sd{$**3/u:>"$K%'JJ~t$DM$%**4*8/25zA~,.7}-EMA 7.3BFm :EJ 7 .F4?3D3D3F/ #||b B,?[AQR4GL//>>W,5::,?O1P1P#DAejj\*:;E(Ub[38UZZ0 0G*,K NN; '!\\11{{))# 2H  % % '$++//CIIKL!\1!zz&))O2NOOO}}$'''),$$ 3ajj445R 8P8P7QR  =ZZ__. 3zl!33 ((*5 =::??!s1::??*;%<rrs@r-rr s{8, $ $ ! !           0aW=W=r/rc~^\rSrSrSrSSU4SjjjrS SjrS S SjjrSrU=r $) OpenAPIResourceTemplateiz7Resource template implementation for OpenAPI endpoints.c f>Uc [5n[T U] UUUUUS9 XlX lXlg)N) uri_templater]rLrzrP)rer}r~rrr) r`rrprr]rLrzrPrrs r-r~ OpenAPIResourceTemplate.__init__sC <5D %#!     r/cnSUR<SUR<SURRS3$)rzOpenAPIResourceTemplate(name=z, uri_template=rr)r]rrrlrs r-r OpenAPIResourceTemplate.__repr__s8.tyym?4K\K\J__fgkgrgrgwgwfxxyzzr/c # /nUR5HupVURUSU35 M [URURUUR SSR U53UR=(d SURR3S[URR=(d /5URS9$7f)z,Create a resource with the given parameters.=-z Resource for r)rrprr]rLrrPr) rappendrrrr]joinrLrlrerPr)r`rrcontext uri_partskeyrs r-create_resource'OpenAPIResourceTemplate.create_resources  ,,.JC   uAeW- .)<<++II;a 345((NmDKKrrs@r-rrsA!% $ ! !       #    0{#'         r/rc^\rSrSrSrS S U4SjjjrS S SjjrSSjrSSjrSSjr SSjr S r U=r $)FastMCPOpenAPIia  FastMCP server implementation that creates components from an OpenAPI schema. This class parses an OpenAPI specification and creates appropriate FastMCP components (Tools, Resources, ResourceTemplates) based on route mappings. Example: ```python from fastmcp.server.openapi import FastMCPOpenAPI, RouteMap, MCPType import httpx # Define custom route mappings custom_mappings = [ # Map all user-related endpoints to ResourceTemplate RouteMap( methods=["GET", "POST", "PATCH"], pattern=r".*/users/.*", mcp_type=MCPType.RESOURCE_TEMPLATE ), # Map all analytics endpoints to Tool RouteMap( methods=["GET"], pattern=r".*/analytics/.*", mcp_type=MCPType.TOOL ), ] # Create server with custom mappings and route mapper server = FastMCPOpenAPI( openapi_spec=spec, client=httpx.AsyncClient(), name="API Server", route_maps=custom_mappings, ) ``` c >[TU]"SSU=(d S0U D6 X lXlX`l[ 5[ 5[ 5[ 5S.Ul[R"U5n Sn U=(d /[-nU GHn [X5nURceURnUbJU"X5nUb>Un[RSU RSU RSUR 35 UR'X5n[)U R*5UR,-U=(d [)5-nU[.R0:XaUR3U UUS 9 MU[.R4:XaUR7U UUS 9 GM U[.R8:XaUR;U UUS 9 GM5U[.R<:XdGML[R?S U RSU R35 U S- n GM [R?S[AU 5U - S35 g!["a>n[R%S U RSU RS US 35 SnAGNwSnAff=f)a Initialize a FastMCP server from an OpenAPI schema. Args: openapi_spec: OpenAPI schema as a dictionary or file path client: httpx AsyncClient for making HTTP requests name: Optional name for the server route_maps: Optional list of RouteMap objects defining route mappings route_map_fn: Optional callable for advanced route type mapping. Receives (route, mcp_type) and returns MCPType or None. Called on every route, including excluded ones. mcp_component_fn: Optional callable for component customization. Receives (route, component) and can modify the component in-place. Called on every created component. mcp_names: Optional dictionary mapping operationId to desired component names. If an operationId is not in the dictionary, falls back to using the operationId up to the first double underscore. If no operationId exists, falls back to slugified summary or path-based naming. All names are truncated to 56 characters maximum. tags: Optional set of tags to add to all components. Components always receive any tags from the route. timeout: Optional timeout (in seconds) for all requests **settings: Additional settings for FastMCP r]zOpenAPI FastMCP)toolresourceresource_templatepromptrNrhriz* mapping customized by route_map_fn: type=zError in route_map_fn for rz. Using default values.)rPzExcluding route: rz$Created FastMCP OpenAPI server with z routesr8)!r}r~rr_mcp_component_fnr _used_namesrparse_openapi_to_http_routesDEFAULT_ROUTE_MAPPINGSrurQrnrorjrlr] Exceptionr_generate_default_namererPrRr0r4_create_openapi_toolr5_create_openapi_resourcer6_create_openapi_templater7infor)r` openapi_specrr] route_maps route_map_fnmcp_component_fn mcp_namesrPrrW http_routes num_excludedrprrrKrrcomponent_name route_tagsrs r-r~FastMCPOpenAPI.__init__sLJ Dd7&7D8D  !1I !(i  ::<H   &B*@@  E-e@I%%1 11"++J' )%URU;aX!RnOMURRS5SnO.UR=(d URSUR3n[ U5n[ U5S:aUSSnU$)zEGenerate a default name from the route using the configured strategy.r&rrr'8N) operation_idrsummaryrjrlr.r)r`rp mcp_names_mapr]s r-r3%FastMCPOpenAPI._generate_default_nameEs%+    !!]2$%7%78))//5a8==Bu||nAejj\$BD~ t9r>9D r/c URUU==S- ss'URUUS:XaU$USURUU3n[RSUSUSSSUS35 U$) z Ensure the name is unique within its component type by appending numbers if needed. Args: name: The proposed name component_type: The type of component ("tools", "resources", or "templates") Returns: str: A unique name for the component rr'zName collision detected: 'z' already exists as a Nrz . Using 'z ' instead.)r/rnro)r`r]component_typenew_names r-_get_unique_nameFastMCPOpenAPI._get_unique_name^s (.!3.   N +D 1Q 6Kq!1!1.!A$!G HIH LL,TF2HX[Y[I\H]^":/  r/c [U5n[URURUR5nUR US5nUR =(d/ UR=(d SURSUR3n[UURURURS9n[URUUUUU[UR =(d /5U-UR"S9n UR$b+UR%X5 [&R)SUS35 U R.n XR0R2U '[&R)S U S URSURSUR 35 g![*a&n [&R-S US U S 35 Sn A NSn A ff=f)z?Creates and registers an OpenAPITool with enhanced description.r*z Executes ribase_description responsesrzr)rrpr]rLrzr{rPrNzTool  customized by component_fnzError in component_fn for tool r. Using component as-is.zRegistered TOOL:  ( ) with tags: )rrrPschema_definitionsopenapi_versionrKrLrErjrlrrzrrwrrerPrr.rnror2rr] _tool_manager_tools) r`rpr]rPcombined_schemar{ tool_namerOenhanced_descriptionr*rfinal_tool_names r-r4#FastMCPOpenAPI._create_openapi_tool|s+51= OOU55u7L7L ))$7     7}} 75<<.%**6  A-oo''++  <<,&'UZZ%2&-MM    ! ! - &&u3 uYK/JKL))6:!!/2 05<<.%**][`[e[eZf g  5i[1#F-. s*F GF??Gc "URUS5nSU3nUR=(d" UR=(d SUR3n[ UUR UR URS9n[URUUUU[UR=(d /5U-URS9nURb+URX5 [RSUS35 [%UR&5n XR(R*U '[RS U S UR,SURSUR35 g![ a&n [R#S US U S 35 Sn A NSn A ff=f)zCCreates and registers an OpenAPIResource with enhanced description.r+ resource://z Represents rN)rrprr]rLrPrNz Resource rQz#Error in component_fn for resource rrRzRegistered RESOURCE: rSrirT)rKrLrErlrrPrzrrrrerPrr.rnror2rrr_resource_manager _resourcesrj) r`rpr]rP resource_namerrOr[r+rfinal_resource_uris r-r5'FastMCPOpenAPI._create_openapi_resources--dJ? $]O4    L LK |2L  A-oo''++  #<<,UZZ%2&-MM   ! ! - &&u7 y6QRS!.AI))*<= #$6#7r%,,q Tabgblblam n  9,r!M-. s*E F(F  Fc ,URUS5nURVs/sH oURS:XdMURPM" nnUR 5 SU3nU(aUSSR SU55-- nUR =(d" UR=(d SUR3n[UURURURS9n SURVs0sHnURS:XdMUR0[UR[5(aURR5O0EUR (a=[UR[5(aS UR;dS UR 0O0E_M snURVs/sH3oURS:XdMUR (dM'URPM5 snS .n [#UR$UUUU U ['UR(=(d /5U-UR*S 9n UR,b+UR-X5 [.R1S US35 U R6n XR8R:U '[.R1SU SUR<SURSUR(35 g s snfs snfs snf![2a&n [.R5SUSU S35 S n A NS n A ff=f)zKCreates and registers an OpenAPIResourceTemplate with enhanced description.r,rlr_rc3.# UH nSUS3v M g7f)rrNr8)rrs r-r:FastMCPOpenAPI._create_openapi_template..s.O;aA3bz;sz Template for rNobjectrL)rrr)rrprr]rLrzrPrNz Template rQz#Error in component_fn for template rrRzRegistered TEMPLATE: rSrirT)rKrzrr]r r!rLrErlrrPrr\rrcopyrrrrerPrr.rnror2rrr` _templatesrj)r`rpr]rP template_namerruri_template_strrOr[template_params_schematemplaterfinal_template_uris r-r6'FastMCPOpenAPI._create_openapi_templates--d4GH ','7'7P'7!::;Ovqvv'7 P(8  chh.O;.O&O O O     N NM%**2N  A-oo''++  ))*A::'  +5aii+F+Fqyy~~'B ==&qyy$77MQYYrrs@r-r(r(sN#R ,0*./3+/ $ $a $a "a  a * a ( a -a )a a a a a HPT&7L 2S <<  < <  < |3  3 3  3 jP  P P  P P r/r()r+rrr)rprrqzlist[RouteMap]rrE)Cr= __future__renumrr(rY collectionsrcollections.abcr dataclassesrrrtypingr r r r mcp.typesr pydantic.networksr rVfastmcp.exceptionsrfastmcp.resourcesrrfastmcp.server.dependenciesrfastmcp.server.serverrfastmcp.tools.toolrrfastmcp.utilitiesrfastmcp.utilities.loggingrfastmcp.utilities.openapirrrrrrfastmcp.serverrr9rn HttpMethodr. RouteMapFn ComponentFnEnumr0r@rEr4r1rurwrrr(r8r/r-rs[<" $(.. %$(88)/%0& H  O P 0y),.>> ? A   dii&   4?,?,?,J gll# *+ *+*+*+Zc=$c=L v=hv=r5 .5 pC WC r/