j[ SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK J r J r SSK J r SSKJr SSKJrJrJrJr SSKJrJr SSKJr SSKrSSKJr SSKJrJ r SS KJ!r!J"r" SS K#J$r$ SS K%J&r& SS K'J(r( SS K)J*r* SSK+J,r,J-r-J.r. SSK/J0r0J1r1 SSK2J3r3J4r4J5r5 SSK6J7r7J8r8Jr SSK9J:r: SSK;Jr> SSK?J@r@ \(a SSKAJBrB SSKCJDrD SSKEJFrF SSK9JGrGJHrH SSK;JIrI \RRS5=(d \L"\"\R"55S- 5rNSrO"SS5rPS)S \LS!\LS-S"\LS-4S#jjrQS)S$\LS-S!\LS-4S%jjrRS*S$\LS-S!\LS-S&\SS'\T\L\4S-4S(jjrUg)+N) AsyncIteratorSequence)BytesIO)Path) TYPE_CHECKINGAnyOptionalcast)unquoteurlparse)run_sync)Client handle_file)Status StatusUpdate)Image)AnyUrl) Starlette)Request) HTMLResponse JSONResponseResponse)MountRoute)ReceiveScopeSend)processing_utils route_utilsutils) BlockFunction)State)Header) SessionStatetypesServerReadResourceContents) BlockContextBlocks) ComponentGRADIO_TEMP_DIRgradiou% Gradio MCP Server

🛠️ Gradio MCP Server

This is the Model Context Protocol (MCP) endpoint for a Gradio app. It is meant to be connected to by an MCP client (such as an AI assistant), not opened directly in a browser.

MCP Server URL

__SERVER_URL_TEXT__

Connect your AI assistant

c &\rSrSrSrSSKJr SSKJr SSK J r SSK J r SSK Jr SHS jr\S \S -4S j5r\S \S \4Sj5r\S\S \4Sj5rS\S \4SjrS \\S -4Sjr\S\S\\S \4Sj5rS \\\44SjrSISjr S \!4Sjr"S\S\\\#4S \$\\\#\\\4S44Sjr%S\#S \\#4Sjr&\S \'S \S -4S!j5r(S\#S"\\)-S \\\#44S#jr*SJS$jr+S%\,S&\S'\S S 4S(jr-S)\S S*4S+jr.\S \4S,j5r/S-SS\S \$\\\\444S.jr0\S/\1S0S1\S \4S2j5r2\S3\1S0S1\#S \4S4j5r3SKS\S5\\\4S -S \$\\\#4\\\\)-44S6jjr4S \54S7jr6S8\\\#4S \$\\\#4\\\\)-44S9jr7S:\#S;\\\\)-S \#4S<jr8\S=\S \9RrS -4S>j5r:\S?\#S \;S -4S@j5r<\SA\9RrSB\S \4SCj5r=S1\#SD\S \SE4SFjr>SGr?g !\a GNf=f)LGradioMCPServeri_z A class for creating an MCP server around a Gradio app. This class requires `mcp` to be installed. Args: blocks: The Blocks app to create the MCP server for. rr%r'r))SseServerTransport)StreamableHTTPSessionManagerc^^SSKnUTlTRR5TlTR 5TlSTl[R"5nU(aURS5SS-OSTl TR5Tl TR5 STlSTlTR#TR SSS 9mS [$S [&S [(S S4UU4Sjjn[*R,S[.S [0S4U4Sjj5nUTlTTlUTlg![an[S5UeSnAff=f)NrzThe `mcp` package is required to use the Gradio MCP integration. Please install it with the `mcp` extra: `pip install gradio[mcp]`./_FT)app json_response statelessscopereceivesendreturnc># URSS5nURS5(d [SUS3SS9nU"XU5IShvN gURS5S :XavS nURS /5HupgUR5S :XdMUn O S U;a;T R U5n[ T R U5S9nU"XU5IShvN gT RXU5IShvN gNN"N 7f)Npathr5)/gradio_api/mcpz/gradio_api/mcp/z/gradio_api/mcp/httpz/gradio_api/mcp/http/zPath 'zD' not found. The MCP HTTP transport is available at /gradio_api/mcp.i)content status_codemethodGETheaderssacceptstext/event-stream)rC)getendswithrlower_server_url_from_scoper_landing_page_htmlhandle_request) r<r=r>rAresponseacceptkeyvalue server_urlmanagerselfs ژC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\gradio/mcp.pyhandle_streamable_http8GradioMCPServer.__init__..handle_streamable_https 99VR(D==$$TF*no #ut444yy"e+"'))Ir":JCyy{i/!&#;(v5!%! > >)5"9 ?s>AC8C2AC8AC8C4C8,C6-C84C86C8r9c># TR5IShvN S7v SSS5IShvN gN!f=fN !,IShvN (df  g=f7f)z7Context manager for managing session manager lifecycle.N)run)r9rTs rVlifespan*GradioMCPServer.__init__..lifespans9{{}} %}} %}}}sLA5A>7> A<A9>AAA  AA)mcp ImportErrorblocks get_api_infoapi_infocreate_mcp_server mcp_server root_pathr get_spacesplit tool_prefixget_tool_to_endpointtool_to_endpointwarn_about_state_inputs _local_url_client_instancer3rrr contextlibasynccontextmanagerrrr[rTrW)rUr_r]espace_idrWr[rTs` @rV__init__GradioMCPServer.__init__tsO     002 002??$>#.r2S8" $ 9 9 ; $$&&*/333u4 $ ?$ ?#*$ ?26$ ? $ ?$ ?L  ' '   mD.A  ( !  &<#K V  sD// E 9 EE r?NcUR$N)rkrUs rV local_urlGradioMCPServer.local_urls rGr<cURS/5=(d /VVs0sHupUR5U_M nnnURSS5nURS5=nb1URS5RS5SR 5nS nURS 5=nb#URS 5SR 5nOURS 5=nbUnURS5=(d S n URSS5n SU R S5-n U R S5(aU SU R S5n U RS5S-n USU U 3$s snnf)aReconstruct the public URL of the MCP endpoint from an ASGI scope. Honours ``X-Forwarded-Proto``/``X-Forwarded-Host`` so that the URL shown on the landing page matches what the user typed into the browser even when Gradio is behind a proxy (e.g. a Hugging Face Space). rHschemehttpsx-forwarded-protoNzlatin-1,rrGsx-forwarded-host,shost localhostrArBr6)/httpz/http/r~z://)rIrKdecoderfstriprJrfindrstrip) r<rQrRrHryforwarded_protohostforwarded_host host_headerhost_strrAs rVrL&GradioMCPServer._server_url_from_scopesf9> )R8P8VTV8VW8V*#399;%8VW8V,&{{+?@ @O M$++I6< >N K!''-a0668D$[[11k >D;;y)8[yy!23TZZ_$ ==, - --$**W-.D{{3#%XJtf--+XsE,rScSn[R"U5n[R"U5n[U5nURnSU;aUR S5SnOUR S5nUS3n[ RSU5RSU5RS[R"U55RS U5$) aHTML landing page shown when a browser navigates to the MCP endpoint. MCP clients connect using the streamable HTTP transport (which requires an ``Accept: text/event-stream`` header). A plain browser ``GET`` would otherwise receive a raw JSON-RPC "Not Acceptable" error, so we serve this informational page instead. It surfaces the server URL and ready to paste configuration snippets for popular MCP clients. z=https://www.gradio.app/guides/building-mcp-server-with-gradiorBrr6z/static__SERVER_URL__ __DOCS_URL____SERVER_URL_TEXT____STATIC_PREFIX__) jsondumpsr rArfr_MCP_LANDING_PAGE_TEMPLATEreplacehtmlescape)rSdocs_url server_url_js docs_url_jsparsedrArd static_prefixs rVrM"GradioMCPServer._landing_page_htmlsS :. jj* *%{{  $ #45a8I C(I$+W- & . ./? O W^[ 1 W*DKK ,C D W(- 8  rGrequestc[R"[UR55nUR SS9n[U5R S5nUR S5(agg)z Gets the route path of the MCP server based on the incoming request. Can be different depending on whether the request is coming from the MCP SSE transport or the HTTP transport. N)queryr6z/gradio_api/mcp/messagesrB)httpxURLstrurl copy_withrrJ)rUrrs rVget_route_pathGradioMCPServer.get_route_pathsS iiGKK()mm$m'#hooc" <<2 3 3-$rGcURRRnUcg[[ US055nSU;a4USR S5nUVs/sHo@R U-PM nnU$gs snf)z Extract the selected tools from the request query parameters and return the full tool names (with the tool prefix). Returns None if no tools parameter is specified (meaning all tools are available). N query_paramstoolsr{)rcrequest_contextrdictgetattrrfrg)rUcontext_requestrrtoolfull_tool_namess rVget_selected_tools_from_request/GradioMCPServer.get_selected_tools_from_request s~ +///*I*I*Q*Q  "GO^RHI l " )//4ECHI54//$65OI" "JsA6 tool_nameexisting_tool_namescz[R"SSU5nUSSnUnSnX;aUSU3-nUS- nX;aMU$)z Sanitizes a tool name to make it a valid MCP tool name (only alphanumeric characters, underscores, <= 128 characters) and is unique among the existing tool names. z [^a-zA-Z0-9]r8Nx)resub)rrtool_name_basesuffixs rVvalid_and_unique_tool_name*GradioMCPServer.valid_and_unique_tool_namesZFF?C; dsO ".&1VH5I aKF.rGc0nURSHnURU5nUb URcM&[URSS5=(dV [ URS5=(a! [URR SS5=(d UR S5nURU-nURU[UR555nX!U'M U$)z Gets all of the tools that are exposed by the Gradio app and also creates a mapping from the tool names to the endpoint names in the API docs. named_endpointsN__name__ __class__r6) raget_block_fn_from_endpoint_namefnrhasattrrlstriprgrsetkeys)rUri endpoint_nameblock_fnfn_namers rVrh$GradioMCPServer.get_tool_to_endpoint*s !]]+<=M;;MJH8;;#6 Z6-HKK5I 5 5z4H- !'', ((72I773/4467I+8Y '!>" rGcURR5HXupURU5nU(dM[SUR55(dMB[ R "S5 MZ g)z- Warn about tools that have gr.State inputs. c3B# UHn[U[5v M g7frt) isinstancer").0inputs rV :GradioMCPServer.warn_about_state_inputs..IsVoU 5% 8 8oszThis MCP server includes a tool that has a gr.State input, which will not be updated between tool calls. The original, default value of the State will be used each time.N)riitemsranyinputswarningswarn)rUr8rrs rVrj'GradioMCPServer.warn_about_state_inputsCsZ!% 5 5 ; ; = A;;MJHxCVhooVVV &!>rGc DURcURRRnUc [ S5eUR U5n[ R"UUURS9n[UR=(d USSSSSSS0S9UlUR$)NCould not find the request object in the MCP server context. This is not expected to happen. Please raise an issue: https://github.com/gradio-app/gradio.r route_pathrdF x-gradio-userr])download_filesverboseanalytics_enabled ssl_verify_skip_componentsrH) rlrcrr ValueErrorrr get_root_urlrdrrv)rUrrroot_urls rV_get_or_create_client%GradioMCPServer._get_or_create_clientPs  (.2oo.M.M.U.UO& p,,_=J"//'%..H %+*($"' !&(%0%D !$$$rGname argumentsr!cUR5nURU5upEURX%5nURR U5nUc[ SU35eUbX;a[ SUS35eUR U5nUceXpRS;a.URSUSn [R"U SU5n O/n URRRn U c [ S5e[U RR55n U R!S S5 U R!S S5 XzX4$) z Prepare and validate arguments for a tool call. Returns: A tuple of (endpoint_name, processed_args, request_headers, block_fn) N"Unknown tool for this Gradio app: zTool 'z#' is not in the selected tools listr parametersrzcontent-lengthr)rget_input_schemaconvert_strings_to_filedatarirIrrra client_utilsconstruct_argsrcrrrrHrpop) rUrrselected_toolsr8filedata_positionsprocessed_kwargsrrparameters_infoprocessed_argsrrequest_headerss rV_prepare_tool_call_args'GradioMCPServer._prepare_tool_call_argshsi==? $ 5 5d ;;;  --11$7  A$HI I  %$*DvdV+NOP P77 F### MM*;< <"mm,=>}MO*88 N  N*.//*I*I*Q*Q  "l 66<<>?,d3OT2oGGrGjobcN# [UR5IShvN nU/$N7f)z Execute a tool call without progress tracking (fast path). Calls job.result() to get the final output without processing intermediate status updates. Returns: The output data as a list. N)r result)rUrrs rV_execute_tool_without_progress.GradioMCPServer._execute_tool_without_progresss$  ++x,s %#%updatecUR[R[R4;agUR[R4;a?SUR SUR S3nURbUSURS3- nU$UR[R4;aUR=(d /HnURcSOS UR3nURb-URb US URS UR3s $URcMjURbMyUS UR3s $ gUR[R[R4;ag g) z Format a status update into a human-readable progress message. Returns: A formatted message string, or None if no message should be shown. zJoined server queue.zIn queue. Position z out of .Nz Estimated time remaining: z seconds.Progressz Progress z: Step z of Processing)coder JOINING_QUEUESTARTINGIN_QUEUErank queue_sizeetaPROGRESS progress_datadescindexlength PROCESSING ITERATING)rmessage progress_unittitles rV_format_progress_message(GradioMCPServer._format_progress_messagesk ;;6//A A) [[V__- -+FKK=ARAR@SSTUGzz%8 INNN [[V__- -!'!5!5!;!; %))1$]%7%7$89 !&&2}7K7K7W ')<)<(=T-BVBVAWX#((49M9M9U#WGM,?,?+@AA"<[[V..0@0@A ArGprogress_tokenc # SnUShvN nURS:Xa[[U5nURU5nURR R RUUU[URR R5S9IShvN US- nMURS:XdMUR(dMURnUR(aMURS5nURS5nU(aU(aUS U3n OU(aUn O U(aUn OS n [U 5eGN9N UR5(aUR5eWS $7f) z Execute a tool call with progress tracking (streaming path). Iterates through job updates to send progress notifications to the client. Returns: The output data as a list. rNstatus)rprogressrrelated_request_idroutputrerrorz: zError!data)typer rrrcrsessionsend_progress_notificationr request_idfinaloutputssuccessrI RuntimeError exception) rUrrsteprrr error_title error_messagemsgs rV_execute_tool_with_progress+GradioMCPServer._execute_tool_with_progresssF ,&{{h&lF377?OO33;;VV'5!% '+. OO;;FF, W   (V\\\~~~"(**W"5K$*JJw$7M"}!, R ?&+$)&&s++; ,   < ==??--/ !f~sKE4E EE B E4EE49E4 E4+AE4E E4 +E4c^TR[TRR=(d S55nUR 5S[S[ [[ 4STRR4U4Sjj5nUR5S[TRR4U4Sjj5nUR5S[TRR4U4Sjj5nUR5S[TRR4U4Sjj5nUR!5S ["[-S[TR$4U4S jj5nUR'5S[TRR(4U4S jj5nUR+5SS[S[ [[ 4S -STRR,4U4S jjj5nU$)z Create an MCP server for the given Gradio Blocks app. Parameters: blocks: The Blocks app to create the MCP server for. Returns: The MCP server. z Gradio Apprrr?c f># TRX5up#pETRURU5nUR(d][ TR 5nTR R UUUTRRRS9IShvN nUSnOSn TRRRb*TRRRRn [TR5IShvN n U R"UUUS.6n U cTRU 5IShvN nOTR!U U 5IShvN nTR#UR$U5nTRRRn TR'U 5n [(R*"U U TR,S9nTR/X5n[1UR2SS5(aSU0nOSnTR4R7UU[1UR2S S5S 9$GNGN#NN7f) z Call a tool on the Gradio app. Args: name: The name of the tool to call. arguments: The arguments to pass to the tool. )rrstaterNr)api_namerHr_mcp_structured_outputFr _mcp_meta)rCstructuredContent_meta)rinsert_empty_staterqueuer$r_ process_apircrrmeta progressTokenr rsubmitrr)pop_returned_stater!rrrrdpostprocess_output_datarrr&CallToolResult)rrrrrr session_state raw_output output_datarclientrrrrrCstructured_contentrUs rV call_tool4GradioMCPServer.create_mcp_server..call_tools ,,T= EM?"44X__nUN>> !-T[[ 9 #';;#:#:%)' OO;;CC $;$ )0 "&??2277C%)__%D%D%I%I%W%WN'(B(BCCmm#*+ ")(,(K(KC(P"PK(,(H(H&)#K 11(2B2BKPK.2oo.M.M.U.UO,,_=J"//'%..H 22;IGx{{$# T R5n/nT RR5Hup#UbX ;aMT RU5nUbBURb5[ URS5(aURR S:waMgT RXB5upVT RX&5upx[URSS5n URT RRUUUU S95 M U$7f)z# List all tools on the Gradio app. N _mcp_typerr0)r description inputSchemar2) rrirrrrrDget_fn_descriptionrrappendr&Tool) rrrrrrErschemar8 tool_metarUs rV list_tools5GradioMCPServer.create_mcp_server..list_toolsEs "AACNE,0,A,A,G,G,I( !-)2Q?? N${{* [99$KK11V;*.*A*A(*V'  11)H #HKKdC  JJOO&$/$*' $'-J6LsDDc ># /nT R5nT RR5GH"up#UbX!;aMT RU5nU(dM*UR(dM=[ URS5(dMZURR S:XdMvURRn[R"SU5n[R"UR5upvnU(aMURT RRUURRUURR S95 GM% U$7f)z List all available resources. rDresource \{([^}]+)\})urirrEmimeType)rrirrrrrD_mcp_uri_templaterfindallr get_function_descriptionrHr&Resourcer_mcp_mime_type) resourcesrrrr uri_templaterrEr8rUs rVlist_resources9GradioMCPServer.create_mcp_server..list_resourcesjs I!AACN,0,A,A,G,G,I( !-)2Q?? NH  [99 --;#+;;#@#@L!#NL!IJ161O1O 2.KQ&:!(( JJ//$0%-[[%9%9,7)1)C)C 0#-J2 &AEE-E E&AE?AEc ># /nT R5nT RR5GH"up#UbX!;aMT RU5nU(dM*UR(dM=[ URS5(dMZURR S:XdMvURRn[R"SU5n[R"UR5upvnU(dMURT RRUURRUURR S95 GM% U$7f)z( List all available resource templates. rDrOrP) uriTemplaterrErR)rrirrrrrDrSrrTr rUrHr&ResourceTemplaterrW) templatesrrrrrYrrEr8rUs rVlist_resource_templatesBGradioMCPServer.create_mcp_server..list_resource_templatess I!AACN,0,A,A,G,G,I( !-)2Q?? NH  [99 --;#+;;#@#@L!#NL!IJ161O1O 2.KQ"z!(( JJ77,8%-[[%9%9,7)1)C)C 8#-J2 r\rQc4># [U5n[TR5IShvN nTRR 5GH8nTR U5nU(dMUR (dM1[UR S5(dMNUR RS:XdMjUR Rn[R"SU5n0nSnU(an[R"U5nUHn URSU S3SU S 35nM [R"S US 3U5n U (aU R5nS nOX@:XaS nU(dGM!UTR S ;a.TR S USn ["R$"U SU5n O['UR 55n UR("U SU06ShvN n U R*S:XdMU R,(dM.U R.nUSSn UR R0nU(a;UR3S5(d%[4R6"WR9S55nTR;WUS9/s $ [=SU35eGNjN N7f)z" Read a specific resource by URI. NrDrOrPFz\{z\}z(?P[^/]+)^$Trrrr.rrrztext/ascii)rC mime_typezResource not found: )rr rrivaluesrrrrDrSrrTrrmatch groupdictrarrlistr8rr r!rW startswithbase64 b64decodeencoder*r)rQr?rrrYrkwargsmatchedpatternparamrirrrrrrgrUs rV read_resource8GradioMCPServer.create_mcp_server..read_resources[ c(C#D$>$>??F!%!6!6!=!=!? ?? NH  [99 --;#+;;#@#@L!#NL!IJF#G!"$))L"9%/E&-oo"&ugT 2d5'4I'G&0!#1WIQ = %*__%6F&*G%,"&w(DMM:K,LL.2mm$> $Y-A-A'-J-J%+%5%5fmmG6L%MF 55(.)6 i"@t3C59: :w@T&-s`$JJ8J$J7JJ0B2J'A,JJJJJ.JBJJJc ># /nT R5nT RR5GH+up#UbX!;aMT RU5nU(dM*UR(dM=[ URS5(dMZURR S:XdMv[R"UR5upVn[R"UR5nUV V Vs/sH7up nT RRU URU S5U (+S9PM9 n n n nURT RRUUU S95 GM. U$s snn n f7f)z List all available prompts. rDpromptr5)rrErequired)rrEr)rrirrrrrDr rUget_function_paramsr&PromptArgumentrIrHPrompt) promptsrrrrrErr8function_params param_name has_defaultrrUs rV list_prompts7GradioMCPServer.create_mcp_server..list_promptssM G!AACN,0,A,A,G,G,I( !-)2Q?? NH  [99 --9161O1O 2.KQ',&?&? &LO>M ! >M9JQ  11!+(2z2(F)4_2 >M !NN ))!*(3&/*/-J<N!s+AE)E)-E) E)&A E)/>E" -# [T R5IShvN nSnT RR5HnT R U5nU(dMUR (dM0[ UR S5(dMMUR RS:XdMiUR RU:XdM O U(d[SU35eU=(d 0nT R U5nUceUT RS;a.T RSUSn[R"USU5nO[UR55nUR"USU06ShvN nURS :XdMUR (dM.UR"nUS S n T R$R'T R$R)S T R$R+S [-W 5S9S9/S9$GNN NZ7f)z1 Get a specific prompt with filled-in arguments. NrDrwzPrompt not found: rrrr.rrrusertextrr)rolerC)messages)r rrirhrrrrD _mcp_namerrarrrkr8rr r!r&GetPromptResult PromptMessage TextContentr) rrr?rrrrrrrrUs rV get_prompt5GradioMCPServer.create_mcp_server..get_prompts$D$>$>??F M!%!6!6!=!=!? ?? NH  [99 --9 --5"@! #5dV!<==!RI;;MJH' '' .? @@"&--0A"B="Q #".!9HH-H H&HB&H(H,H-H0HHA)HHHrt)r(rr_rrArrr&r;rLrkrIrZrVrar_rtrr*rr{rr) rUserverrArLrZrartrrs ` rVrb!GradioMCPServer.create_mcp_serversS!2!2!BlCD    D D "&sCx.D  ZZ & &D  D L    " $tzz"7"  " H     d4::+>+>&?  ! D  ' ' ) tDJJ4O4O/P  * B    @ ;Vc\@ ;d4;T;T6U@ ; @ ;D    $ D):):$;$  $ L    :>5 5 "&sCx.4"75  ZZ ' '5  5 n rGr9subpathrdc ^^SnTRU5mUTlUU4SjnURU[[ STR S9[ SUS9[ STRS9[ STRS9/S95 g ) z Launch the MCP server on the SSE transport. Parameters: app: The Gradio app to mount the MCP server on. subpath: The subpath to mount the MCP server on. E.g. "/gradio_api/mcp" root_path: The root path of the Gradio Blocks app. z /messages/c># TRURURUR5IShvN nTRR USUSTRR 55IShvN SSS5IShvN [5$NaN N!,IShvN (df  N'=f![an[S[U535 eSnAff=f7f)NrrzMCP SSE connection error: ) connect_sser<r=_sendrcrZcreate_initialization_optionsr Exceptionprintr)rstreamsrorUsses rV handle_sse5GradioMCPServer.launch_mcp_on_sse..handle_sse`s ??MM7??GMM//--  EEG z! 23q6(;< sC&5B<BB<?B"=B>B" B< B  B<C&B<B" B<"B9(B+ ) B95B<< C#CC##C&z/schema)endpointz/sse)r9r6)routesN) r2rdmountrrget_complete_schemarhandle_post_messagerW)rUr9rrd messages_pathrrs` @rVlaunch_mcp_on_sse!GradioMCPServer.launch_mcp_on_sseSs% %%m4"   !!%!9!9&:6,C,C,CD#4#>#>?  rGrzBlockFunction | Nonecx^[U4SjURRR55S5nU$)z Get the BlockFunction for a given endpoint name (e.g. "/predict"). Parameters: endpoint_name: The name of the endpoint to get the BlockFunction for. Returns: The BlockFunction for the given endpoint name, or None if it is not found. c3j># UH(nURTRS5:XdM$Uv M* g7f)r6N)r.r)rrrs rVrBGradioMCPServer.get_block_fn_from_endpoint_name..s1 2B;;-"6"6s";;2s#3 3N)nextr_fnsrh)rUrrs ` rVr/GradioMCPServer.get_block_fn_from_endpoint_name~s9 ++//002    rGcg)ze Sentence prompting the agent to use the upload_file_to_gradio tool if a file is passed as an input. z If a user passes a file as an input, use the upload_file_to_gradio tool, if present, to upload the file to the gradio app and create a Gradio File Input. Then use the returned path as the input to the toolrrus rV_file_data_tool_description+GradioMCPServer._file_data_tool_descriptions `rGrc[R"UR5up4nURX$5upgURSLaSnOURcW[ U5S:aX0R - nU(a2UURS5(aSOSS-SRU5-- nO)URn[ U5S:aX0R - n[U[5(deX44$)z Get the description of a function, which is used to describe the tool in the MCP server. Also returns the description of each parameter of the function as a dictionary. Fr5rrz Returns: z, ) r rUrrapi_descriptionlenrrJjoinrr)rUrrrErreturnsr8rs rVrG"GradioMCPServer.get_fn_descriptions,1+I+I(+++V(  $ 5 5i L  # #u ,K  % % -%&*??? &//44R#"#ii() #22K%&*??? +s++++&&rGrzComponent | BlockContextrc[U5H.up#[U[5(dMURUS5 M0 U$)zy Insert None placeholder values for any State input components, as State inputs are not included in the endpoint schema. N) enumeraterr"insert)rriinput_component_types rVr3"GradioMCPServer.insert_empty_states9(1'8 #A.66 At$(9 rG componentsc~[U5H-up#[U[5(dMURU5 M/ U$)z Remove any values corresponding to State output components from the data as State outputs are not included in the endpoint schema. )rrr"r)rrrcomponent_types rVr9"GradioMCPServer.pop_returned_states5"+:!6 A.%00 "7 rGrc URRU5nUc[SU35eURSnURU5nUceSUSVs0sHBnUS0USEU(aUSU;a SX&S0O0ESU;aUS(aS US0O0E_MD snS .nUSVs/sH!nURS S 5(aMUSPM# nnU(aXS 'UR U5$s snfs snf)aq Get the input schema of the Gradio app API, appropriately formatted for MCP. Parameters: tool_name: The name of the tool to get the schema for, e.g. "predict" parameters: The description and parameters of the tool to get the schema for. Returns: - The input schema of the Gradio app API. - A list of positions of FileData objects in the input schema. rrobjectrparameter_namerrEparameter_defaultdefault)r propertiesparameter_has_defaultFrx)rirIrrasimplify_filedata_schema) rUrrrr endpoint_infoprJrxs rVr GradioMCPServer.get_input_schemasi--11)<  A)MN N--(9:'++M: ((('|45A"# &i &&!,<*=*K' 5E3F(GH &/!3:M8N#A&9$:; & 5 *#<0 0550%8 A 0  !): ,,V441" sA C5/C: C:c# UR(d [05$[[US055nSnSU;aUSR S5n[ U5nSn/nUR R5GH`upxUbXs;aMURU5n U b U RceURX5upURX{5up[U 5S:a U(dSn[R"U R5n/nUR5HRunnU[LdU[ [LdM!UR#SS 5R%5nUR'U5 MT S n[)U RS 5(aU RR*nUUU R,S .nU(aUUS 'UU U US.nUR'U5 GMc [U5$7f)aZ Get the complete schema of the Gradio app API. For debugging purposes, also used by the Hugging Face MCP server to get the schema for MCP Spaces without needing to establish an SSE connection. Parameters: request: The Starlette request object. Returns: A JSONResponse containing a dictionary mapping tool names to their input schemas. rNrr{FrTr8-rrD)file_data_presentmcp_typerrH)rrErFr6)rarrrrfrrirrrrGrrr get_type_hintsr#r rrKrHrrDr.)rUrrrrrschemasrrrrErrJr type_hintsrequired_headersr~ type_hint header_namerr6infos rVr#GradioMCPServer.get_complete_schemas}}# #GG^R@A  l " )//4E ZN!(,(=(=(C(C(E $I)i.M;;MJH'HKK,C CC&*&=&=h&R #K)-)>)>y)U &F%&*3D$(!--hkk:J! )3)9)9);% I&)x7G*G","4"4S#">"D"D"FK$++K8*< Hx{{K00#;;00&7$!)!2!2D  "2Y"*% D NN4 I)FLG$$s D8G*>B,G*rJc ^^^S[S[[[4S[4SjmS S[S[[[ -S-S[[[4S-S[4UUU4Sjjjm/mT"U5nUT4$) a} Parses a schema of a Gradio app API to identify positions of FileData objects. Replaces them with base64 strings while keeping track of their positions so that they can be converted back to FileData objects later. Parameters: schema: The original schema of the Gradio app API. Returns: A tuple containing the simplified schema and the positions of the FileData objects. objdefsr?c`[U[5(dgSU;aCUSnURS5(a'URS5SnUR U05nOgUR S05nUR S05nSU;aCUSnURS5(a'URS5SnUR U05nOgUR S05R S05nUR S 05R S5nUR S 5S :H=(d US :H$) NFz$refz#/$defs/r6r7rr6_typerconstzgradio.FileData)rrrlrfrI)rrrefrQpropsr6 type_field default_types rVis_gradio_filedataDGradioMCPServer.simplify_filedata_schema..is_gradio_filedataQsc4((}&k>>*--))C.,C((3+C GGL"-E99VR(D~6l>>*--))C.,C88C,D ,377DJ88Ir266w?Lw'+<<5#44 rGNnoderAc>Uc/nUc0n[R"U5n[U[5(aSU;aUR US5 T "X5(aDT R UR55 SHnUR US5 M SUS'SUS'0nSU;=(a SU;nUR5HKup6U(aUS:Xa T "XaU5XC'MUR U5 T "XaU5XC'UR 5 MM U$[U[5(aQ/n[U5H>upxUR U5 UR T "XU55 UR 5 M@ U$U$)N$defs)radditional_descriptionrstringrz1Gradio File Input - a http or https url to a fileformatr) copydeepcopyrrrrHrrrkr) rrArrQris_schema_rootrRritemrrtraverses rVr:GradioMCPServer.simplify_filedata_schema..traverseosV ||==&D$%%d?KKW .%d11&--diik:Pd+ Q#+DL%XDN!'4!HLD4H"&**,JC%#*=&.uD&A  C(&.uD&A  #/ D$''(GAKKNMM(4t"<=HHJ / KrGNN)rrrboolrkint)rUrJsimplified_schemarrrs @@@rVr(GradioMCPServer.simplify_filedata_schemaBs C tCH~ $ @,0*.* * sSy/D(* sCx.4'*  * * X57$V, "444rGrRrcr^^SS[S[[[-S-S[4UU4SjjjmT"U5$)a Convert specific string values back to FileData objects based on their positions. This is used to convert string values (as base64 encoded strings) to FileData dictionaries so that they can be passed into .preprocess() logic of a Gradio app. Parameters: value: The input data to process, which can be an arbitrary nested data structure that may or may not contain strings that should be converted to FileData objects. filedata_positions: List of paths to positions in the input data that should be converted to FileData objects. Returns: The processed data with strings converted to FileData objects where appropriate. Base64 encoded strings are first saved to a temporary file and then converted to a FileData object. Example: >>> convert_strings_to_filedata( {"image": "data:image/jpeg;base64,..."}, [["image"]] ) >>> {'image': FileData(path='')}, NrrAr?c :>Uc/n[U[5(a0UR5VVs0sHup#UT"X1U/-5_M snn$[U[5(a*[ U5VVs/sHupET"XQU/-5PM snn$[U[ 5(aoUT;aiUR S5(a$[[R"U[55$UR S5(a [U5$[SU35eU$s snnfs snnf)Nzdata:)zhttp://zhttps://zSInvalid file data format, provide a url ('http://...' or 'https://...'). Received: ) rrrrkrrrlrrsave_base64_to_cacheDEFAULT_TEMP_DIRr)rrArQrRrrrrs rVr=GradioMCPServer.convert_strings_to_filedata..traverses|$%%IMIU:3C%66D$''BKD/R/wqqcz2/RRD#&&43E+E??7++'(==dDTU__%<==&t,,$mnrmstK%Ss D/Drt)rrkrr)rUrRrrs `@rVr+GradioMCPServer.convert_strings_to_filedatas;2 3 d39o&<   2rG file_pathc.[RRU5(dg[RRUR 55SnU[ R "5;ag[ R"U5$![a gf=f)zU If a filepath is a valid image, returns a PIL Image object. Otherwise returns None. Nr) osrAexistssplitextrKrregistered_extensionsopenr)rexts rV get_imageGradioMCPServer.get_imagest ww~~i((ggy01!4 e113 3 ::i( (  s1B BB file_datac[U[5(apURS5=n(aX[U[5(aBUR S5(a,[ UR SS5S5R5$gg)z If a file_data is a valid FileDataDict with a url that is a data:image/svg+xml, returns bytes of the svg. Otherwise returns None. rzdata:image/svgr{rN)rrrIrrlr rfro)rrs rVget_svgGradioMCPServer.get_svgsj i & &9==3G,GC,G#s##7G(H(Hsyya034;;==rGimagerc[5nURX!S9 [R"UR 55R S5$)z/ Returns a base64 encoded string of the image. )rutf-8)rsaverm b64encodegetvaluer)rrbuffers rVget_base64_dataGradioMCPServer.get_base64_datas<  6 ) 1299'BBrGrz&types.TextContent | types.ImageContentc/n[R"XS5nUGHnURU5=n(a[R"U5R S5nSn[R "XTS[5n[R"U5n USU 3n URRSXgS9URRSS U 3S 9/n GO[R"U5(aURUS 5=n (aU R=(d S n UR!X5nS U R#53nURRSXgS9URRSSUS=(d US 3S 9/n OXURRS[%US=(d US 5S 9/n O$URRS[%U5S 9/n UR'U 5 GM U$)z Postprocess the output data from the Gradio app to convert FileData objects back to base64 encoded strings. Parameters: data: The output data to postprocess. Nrz image/svg+xml orig_namez/gradio_api/file=r)rrrRrzSVG Image URL: rrApngzimage/z Image URL: r)r add_root_urlrrmr rsave_bytes_to_cacherrencode_file_pathr& ImageContentris_file_obj_with_metarrr rKrextend)rUrr return_valuesr svg_bytes base64_datamimetypesvg_path encoded_pathsvg_url return_valuer image_formats rVr:'GradioMCPServer.postprocess_output_datas  ,,TTBF LL00y0$..y9@@I *+??"5!69I ,<::5:#(<<#85L"&"6"6u"KK!' (:(:(<'=>H //!({0 ..!'#.ve}/Nv.O!P/ $L ..!'c&-2Q6&>.R/$L !% 6 6FV 6 UV   .QRrG) rlrkrar_rWr[rTrcrdrgri)r_r,)r?N)r?r(rt)@r __module__ __qualname____firstlineno____doc__r]r& mcp.serverr( mcp.server.lowlevel.helper_typesr*mcp.server.sser2"mcp.server.streamable_http_managerr3r^rqpropertyrrv staticmethodrrLrMrrrkrrrrrhrjrrrtuplerrrrrr)rbrrrrrGrr3r9rrrrrrrbytesrr r:__static_attributes__rrGrVr1r1_s# %I5SH=T3:.e...< s s  4 %g %# % cT1A -0X " d38n 2 %v%0-H-H$(cN-H sDItCH~> ?-H^  S #*>,,(+c , c3h,\_B ) Y) ) ) QU) V  ,`S`` '''47' sDcN" #'6 34 <@     78 @C    -10505cNT)05 tCH~tDsO44 5 05d>%L>%@[538n[5 tCH~tDsO44 5[5z22.24c ?.C2 2h S U[[4%7   3 54<  Cu{{CCCCCC44#&4 6 74O$    sHHHr1rYrErgc^^^UUU4SjnU$)z0Decorator to mark a function as an MCP resource.cR>SUlTUlTUlT=(d SUlU$)NrOz text/plain)rDrS_mcp_descriptionrW)rrErgrYs rV decoratorresource..decorator9s,! +)%5 rGr)rYrErgr1s``` rVrOrO4s  rGrc^^UU4SjnU$)z.Decorator to mark a function as an MCP prompt.cX>SUlT=(d URUlTUlU$)Nrw)rDrrr0)rrErs rVr1prompt..decoratorFs' *r{{ ) rGr)rrEr1s`` rVrwrwCs rGstructured_outputr2c ^^^^UUUU4SjnU$)a Decorator to mark a function as an MCP tool (optional, since functions are registered as tools by default). Can be used to configure various aspects of the tool. Parameters: name: The name of the tool. Overrides the default name of the function. description: The description of the tool. Overrides the default description from the function's docstring. structured_output: Whether the tool should return structured output (implementation is quite limited at the moment). If True, the output will be wrapped in a dictionary with the key "result" and the value being the output of the function. Recommended to keep this False unless you have a specific reason to need the structured output. _meta: Additional metadata for the tool. cN>SUlTUlTUlTUlTUlU$)Nr)rDrr/r0r0)rr2rErr6s rVr1tool..decorator`s-  $5!)  rGr)rrEr6r2r1s```` rVrrOs" rGr)NNFN)Vrmrmrrrrrtempfilercollections.abcrriorpathlibrtypingrrr r urllib.parser r gradio_client.utilsr rranyio.to_threadr gradio_clientrrrrPILrpydanticrstarlette.applicationsrstarlette.requestsrstarlette.responsesrrrstarlette.routingrrstarlette.typesrrrr/rr gradio.blocksr!gradio.componentsr"gradio.route_utilsr#gradio.state_holderr$r]r&r%r(r&r*r+r,r-environrIr gettempdirrrr1rOrwrrrrrGrVrPsb  355** $-4,&DD*0077'#%,!E2+::>>"34   (*9gT MMl&PT  $'$J BE*  t t "##'  *t S>D rG