kKjDldZddlmZddlZddlmZddlmZddl m Z m Z m Z ddl Z ddlmZddlZddlmZddlmZeGd d ZeGd d ZeGd dZeGddZeGddZddZddZddZGddeeZddZddZ d d!dZ y)"z+Utilities for inspecting FastMCP instances.) annotationsN) dataclass)Enum)AnyLiteralcast)FastMCP)ClientceZdZUdZded<ded<ded<ded<d Zd ed <d Zd ed <d Zd ed<d Zded<d Z ded<d Z d ed<y )ToolInfozInformation about a tool.strkeyname str | None descriptiondict[str, Any] input_schemaNdict[str, Any] | None output_schemarlist[str] | Nonetagstitlelist[dict[str, Any]] | Noneiconsmeta) __name__ __module__ __qualname____doc____annotations__rrrrrrj/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/fastmcp/utilities/inspect.pyr r s\# H I  +/M(/)-K&-!D !E:)-E &-"&D &r"r cveZdZUdZded<ded<ded<dZded <dZd ed <dZded <dZded <dZ ded<y) PromptInfozInformation about a prompt.r rrrrNr argumentsrrrrrr) rrrrr r&rrrrr!r"r#r%r%"sK% H I-1I*1!D !E:)-E &-"&D &r"r%ceZdZUdZded<ded<ded<ded<dZded <dZd ed <dZd ed <dZded<dZ ded<dZ d ed<y) ResourceInfozInformation about a resource.r rurirrrN mime_typerrrrrrrr) rrrrr r*rrrrrr!r"r#r(r(0s[' H H  Iz )-K&-!D !E:)-E &-"&D &r"r(ceZdZUdZded<ded<ded<ded<dZded <dZd ed <dZd ed <dZd ed<dZ ded<dZ ded<dZ d ed<y) TemplateInfoz&Information about a resource template.r r uri_templaterrrNr*r parametersrrrrrrr) rrrrr r*r.rrrrrr!r"r#r,r,@sg0 H  Iz (,J%,)-K&-!D !E:)-E &-"&D &r"r,ceZdZUdZded<ded<ded<ded<ded <ded <ded <d ed <ded<ded<ded<ded<ded<y) FastMCPInfoz.Information extracted from a FastMCP instance.r rr instructionsversion website_urlrrfastmcp_version mcp_versionintserver_generationzlist[ToolInfo]toolszlist[PromptInfo]promptszlist[ResourceInfo] resourceszlist[TemplateInfo] templatesr capabilitiesN)rrrrr r!r"r#r0r0QsR8 I  &&  !!!!  r"r0ct K|jd{}|jd{}|jd{}|jd{}g}|D] }|j |j }|j t|j|j xs |j|j|jr |jni|j|jr|jjnd|jrt|jnd|j |j"r(|j"Dcgc]}|jc}nd|j$ #g} |D]} | j t'| j| j xs | j| j| j(r(| j(D cgc]} | jc} nd| jrt| jnd| j | j"r(| j"Dcgc]}|jc}nd| j$g} |D]} | j t+| jt-| j.| j | j| j0| jr| jjnd| jrt| jnd| j | j"r(| j"Dcgc]}|jc}nd| j$ g}|D]}|j t3|j|j4|j |j|j0|j6|jr|jjnd|jrt|jnd|j |j"r(|j"Dcgc]}|jc}nd|j$ ddid d d dd iid }t9|j:d rH|j:j"r2|j:j"Dcgc]}|jc}nd}t9|j:d r|j:j<nd}t?|j |j@t9|dr |jBn|j:jB||tDjFtHjJjCdd|| | || S7x7c7N79cc}wcc} wcc}wcc}wcc}wcc}ww)zExtract information from a FastMCP v2.x instance. Args: mcp: The FastMCP v2.x instance to inspect Returns: FastMCPInfo dataclass containing the extracted information N)r rrrrrrrrrrrrrr&rrrr rr)rrr*rrrrr rr-rrr*r.rrrrr listChangedTF subscriberBr8r:r9loggingrr3r2mcp rr1r2r3rr4r5r7r8r9r:r;r<)& list_tools list_promptslist_resourceslist_resource_templates to_mcp_toolrappendr rr inputSchemarr model_dumprlistrrrr%r&r(r r)r*r,r-r.hasattr _mcp_serverr3r0r1r2fastmcp __version__ importlibmetadata)rG tools_list prompts_listresources_listtemplates_list tool_infostoolmcp_toolicon prompt_infospromptargresource_infosresourcetemplate_infostemplater< server_iconsserver_website_urls r#inspect_fastmcp_v2rjds~~''J))++L--//N6688NJ###3 HHYY*$(( ,,5=5I5IX11r"00=A=M=MD,,779SW(, T$))_tjj::6:ZZ@ZTt(Z@YY  (L JJ[[.FJJ"..##8>7G7GH7G3>>+7GH*0++T&++&4ll<<6<\\B\Tt(\B[[  &N" LL %]]$00",,''%00;;=,4MMT(--(tnn>>6>^^D^Tt(^D]]  #*N" LL%22]]$00",,#..''%00;;=,4MMT(--(tnn>>6>^^D^Tt(^D]]  #. &#(?!5) L 3??G ,1F1F(+'<'<='sV8VV8VV8VV8VC9V8V/Aj@j9dd|| | || cdddd{S7F71777#t $rg}YwxYwcc}wcc} wcc}wcc}wcc}wcc}w7D#1d{7swYyxYww)zExtract information from a FastMCP v1.x instance using a Client. Args: mcp: The FastMCP v1.x instance to inspect Returns: FastMCPInfo dataclass containing the extracted information Nrr>r&r?r@rArBTFrCrE websiteUrlrGrI)!r rJrKrLrM ExceptionrOr rrrPrSrrQr&r%r(r r)mimeTyper, uriTemplateinitialize_result serverInforlr0rTr1r2rUrVrWrX)rGclient mcp_tools mcp_prompts mcp_resources mcp_templatesr]r_r`ra mcp_promptr&rcrd mcp_resourcerf mcp_templater< server_inforhris r#inspect_fastmcp_v1r|sMc{{f ++-- "//11 $3355  "("@"@"BBM  !H    ! ( 4 49A9M9M!5!5SU"& $x1hnn:BH4??,H  "& %JIz;/J4H4H9C9M9MN9M#S^^-9M N   "# * 6 6'z73 8H8H:D9I9IJ9I4??,9IJ   &,)L  ! !L,,-L,,-%** , 8 8*33 $|W5,:L:L:F9K9KL9K4??,9KL  *&)L  ! !L445!$\%=%=!>%** , 8 8*33# $|W5,:L:L:F9K9KL9K4??,9KL **$T*',UC%u-  ..99 {G,1B1B,7+<+< =+<4T__ +< =  '.k<&HK " "d %%55OO++*#//!**2259 $$% g{{-15C M  IOK(M*M$ >W{{{sR.QR.RQRQRQ!R Q'3Q$4Q'8A;R3Q9 AR Q>!AR=RBR.R BR R "7ARR)BR R.RR.RR!R$Q'' Q62R5Q66!RR.R+R" R+'R.cKt|trt|d{Stt t t |d{S7,7w)a`Extract information from a FastMCP instance into a dataclass. This function automatically detects whether the instance is FastMCP v1.x or v2.x and uses the appropriate extraction method. Args: mcp: The FastMCP instance to inspect (v1.x or v2.x) Returns: FastMCPInfo dataclass containing the extracted information N) isinstance FastMCP1xr|rjrr r)rGs r#inspect_fastmcprzsB#y!',,,'WS\3(?@@@-@s!AA'A A AAceZdZdZdZdZy) InspectFormatz"Output format for inspect command.rUrGN)rrrrFASTMCPMCPr!r"r#rrs,G Cr"rc\|j|j|j|j|j|j |j d|j|jd|j|j|j|jd}tj|dS)zFormat FastMCPInfo as FastMCP-specific JSON. This includes FastMCP-specific fields like tags, enabled, annotations, etc. )rr1r2r3r generationr<rUrG)server environmentr8r9r:r;rHindent)rr1r2r3rr7r<r4r5r8r9r:r; pydantic_coreto_json)inforesults r#format_fastmcp_inforsII --||++ZZ00 -- ++## <<^^^^#F(   22r"c rKt|4d{}|jd{}|jd{}|jd{}|j d{}|j j }tjtjjdd|i|j|j|j|jd}t!j"|dcdddd{S777777#1d{7swYyxYww)zFormat server info as standard MCP protocol JSON. Uses Client to get the standard MCP protocol format with camelCase fields. Includes version metadata at the top level. NrGr)rrrr<r8r9r:resourceTemplatesrHr)r list_tools_mcplist_prompts_mcplist_resources_mcplist_resource_templates_mcprqrrrUrVrWrXr2r8r9r:rrr)rGrs tools_resultprompts_resultresources_resulttemplates_resultr{rs r#format_mcp_infors c{{f#2244 %6688!'!:!:!<<!'!C!C!EE..99 #.. ))11%8&!''%--)33!1!C!C  $$VA61{{48<E {{{sD7DD7D"DD"DD"DD"2D3BD" D7D D7D"D"D"D" D7"D4(D+ )D40D7cKt|tr t|}|tjk(rt |d{S|tj k(r |t |d{}t|Std|7E7w)a0Format server information according to the specified format. Args: mcp: The FastMCP instance format: Output format ("fastmcp" or "mcp") info: Pre-extracted FastMCPInfo (optional, will be extracted if not provided) Returns: JSON bytes in the requested format NzUnknown format: ) r~r rrrrrr ValueError)rGformatrs r# format_infors &#v& """$S))) =(( ( <(--D"4((+F8455* .s"=B B'B 'B(B B )rGz FastMCP[Any]returnr0)rGrrr0)rGFastMCP[Any] | FastMCP1xrr0)rr0rbytes)rGrrr)N)rGrrz)InspectFormat | Literal['fastmcp', 'mcp']rzFastMCPInfo | Nonerr)!r __future__rimportlib.metadatarW dataclassesrenumrtypingrrrrmcp.server.fastmcpr rrUr fastmcp.server.serverr r%r(r,r0rjr|rr rrrrr!r"r#rs1"!%%3)  ' '  '  ' '  '  ' '  '  ' '  '  !! !$EPK \A$C3:7H $6 !6 56 6 6r"