kKj dZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlmZddlmZddlmZddlZddlZddlZddlmZddlmZdd lmZm Z m!Z!dd l"m#Z#dd l$m%Z%e%e&Z'd'd Z(Gd dZ)d(dZ*dZ+dZ,dZ-dZ.dZ/d)dZ0d*dZ1d+dZ2d,dZ3d-dZ4d.dZ5 d/dZ6 d/dZ7 d0dZ8ddd  d1d!Z9d2d3d"Z:d#d$dddd% d4d&Z;y)5u=Dev server for previewing FastMCPApp UIs locally. Starts the user's MCP server on a configurable port, then starts a lightweight Starlette dev server that: - Serves a Prefab-based tool picker at GET / - Proxies /mcp to the user's server (avoids browser CORS restrictions) - Serves the AppBridge host page at GET /launch The host page uses @modelcontextprotocol/ext-apps to connect to the MCP server and render the selected UI tool inside an iframe. Startup sequence ---------------- 1. Download ext-apps app-bridge.js from npm and patch its bare ``@modelcontextprotocol/sdk/…`` imports to use concrete esm.sh URLs. 2. Detect the exact Zod v4 module URL that esm.sh serves for that SDK version and build an import-map entry that redirects the broken ``v4.mjs`` (which only re-exports ``{z, default}``) to ``v4/classic/index.mjs`` (which correctly exports every named Zod v4 function). Import maps apply to the full module graph in the document, including cross-origin esm.sh modules. 3. Serve both the patched JS and the import-map JSON from the dev server. ) annotationsN)Path)Any) urlencode) Starlette)Request) HTMLResponseResponseStreamingResponse)Route) get_loggerctj|jddjddjddjddjd d S) z;Serialize JSON for embedding inside an HTML script element.&z\u0026z\u003eu
z\u2028u
z\u2029)jsondumpsreplacevalues e/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/fastmcp/cli/apps_dev.py_json_for_scriptr:sQ 5 i i i 9 % 9 % cBeZdZdZd dZd dZd dZd d dZd dZd dZ y) _MessageLogzDIn-memory buffer of MCP JSON-RPC messages flowing through the proxy.c<g|_d|_i|_i|_y)Nr)_entries_counter_request_methods_request_timesselfs r__init__z_MessageLog.__init__Ns .0  6868rc2|jdd}|jd}tj}|||j|<||j|<|xjdz c_|j j |j|d||dy)Nmethodunknownidrequestr' timestamp directionr%body)gettimerr rrappend)r"r-r% jsonrpc_idr+s r log_requestz_MessageLog.log_requestTs(I.XXd^ IIK  !06D ! !* -.7D   +   mm&&    rc Rd|vrgd|vrc|xjdz c_|jj|jtjd|j dd|dy|j d}||j j |dnd}||jj |dnd}tj}|rt||z dzdnd}|xjdz c_|jj|j|d|||d y) Nr%r'r( notificationr&r*iresponse)r'r+r,r%r- duration_ms) rrr0r/r.rpopr round)r"r-r1r% request_timer+r6s r log_responsez_MessageLog.log_responsefs# t D 0 MMQ M MM --!%!/"hhx;   XXd^ %  ! ! % %j$ 7 %    # #J 5  IIK ;GE9|+t3Q 7T    mm&' *   rcR|jDcgc] }|d|kDs |c}Scc}w)Nr')r)r"since_ides r get_sincez_MessageLog.get_sinces)==?=aAdGh,>=???s $$c|jdd}|xjdz c_|jj|jt jd||dy)Nr%r&r(bridger*)r.rrr0r/)r"r-r%s r log_bridgez_MessageLog.log_bridgesP(I.   mm!YY[%    rc|jj|jj|jjyN)rclearrr r!s rrDz_MessageLog.clears6  ##% !!#rNreturnNone)r-dict[str, Any]rFrG)r)r<intrFlist[dict[str, Any]]) __name__ __module__ __qualname____doc__r#r2r:r>rArDrrrrKs%N9  $( T@  $rrc  |sy d|vr|jddjD]g}|jdstjt j 5|jt j|dddddiyt j|}t|tr|D]}|j|y|j|y#1swYxYw#t j tf$rYywxYw)zBParse accumulated proxy response bytes and log as message entries.Ntext/event-streamutf-8rerrorsdata: ) decode splitlines startswith contextlibsuppressrJSONDecodeErrorr:loads isinstancelist TypeError)lograw content_typeliner-items r_log_response_bytesrfs  , . 79 =HHJ??8,#,,T-A-AB((DH)=>CBK ::c?D$% D$$T*!  &CB  ) ,   s:9C1#C1"(C% C1=C1C1%C. *C11D  D z1.0.1z1.25.2a~ {title} {import_map_tag}
{status_text}
u0 FastMCP Dev — {tool_name} {import_map_tag}
Launching {tool_name}…
uL c6|jdtdzS)z0Inject the MCP message log panel before .zz )r_LOG_PANEL_HTML)htmls r_inject_log_panelrjs 4<< ?[#@ AArcdD]Y}|j|}t|ts%|jd}t|tsG|jdsYyy)z=Return True if the tool has a UI resourceUri in its metadata.)meta_metaui resourceUriTF)r.r^dict)toolkeymrns r_has_ui_resourcertsM  HHSM a tB"d#}(= ! rc ddl}ddl}|jdxsi}|jdxsg}i}|jD]\}}|jdd}dD]r} | |vs|| D cgc](} t | t r| jddk7r| *} } | r2| D cgc]} d| vs| jd} } d D] } | | vs| }nn|xd k(rt }n7xd k(rt}n*xd k(rt}nxd k(rnxdk(rnnt}n t}|jdxs |jddj}|jd}||v}|r|jj}nd|vr|d}nd}|dz}i}|jdrddlm}|t!|d}|jddk(xs>t |jdt xr|djddk(xs|dv}|r dddii|d<||j"d|||d|f||<|j$|jdfi|Scc} wcc} w)zKDynamically create a Pydantic model from a JSON Schema for form generation.rN propertiesrequiredtypestring)anyOfoneOfnull)objectarrayryintegernumberbooleanrrrr}r~title_ descriptiondefaultenum)Literalformattextarearn)r}r~json_schema_extra)rrrFormrO)pydanticpydantic.fieldsr.itemsr^rprIfloatboolstrrrfieldsPydanticUndefinedtypingrtupleField create_model) tool_name input_schemarrvrwfield_definitions prop_nameprop json_typerrtnon_nulltypes candidatepy_typerr is_requiredrextrar use_textareas r_model_from_schemars!-!1!1,!?!E2J&**:6<"H(*%++- 4HHVX. &Cd{"#Y&!!T*quuV}/F& 4<LHq! QUU6]HEL& %-(1I!&-&0 #G#!HY%6%6sC%@%F%F%Hhh}- 8+ oo77G $ 9oGGnG " 88F  &eDL12G HHX * , 0488D>409JNN6*j8 0 //  *.0D)EE% &  HNN u+ IN ( )$S.` !8 IOO$5#6d!; Q?P QQU Ms/-I$ I.Ic ddlm}m}m}m}ddlm}ddlm}m }m }m } m } m } m} m} m}m}m}ddlm}ddlm}m}|s;|dd 5}|d | d d d d |d j3S|dd}dJd}|dd 5}|d t5|dkDr]|d5| d|d|d|d5|D]}||||d|d|k( d d d d d d n|||dd| d|5|D]}|d}|j7dxsd }|j7d!xsi}t9||}d|i}|j:D] }||||<||d"d#}||d$d%&}d'|} d(}!| ||)5|d5|r|j=d*}"d+}#t5|"|!kr | ||#,nd-|}$d*j?|"d |!}%| |$d.5| d.d.)5|dd/ 5| |%|#,|d0d1d2||$d3d45d d d d d d | d3d3)5|dd/ 5| ||#,|d6d1d2||$d.d45d d d d d d d d d | | d75| d7d7)5|d5|dd/ 5|d8d|d9d1d2|| d:d45d d d ||jAd;||||<=5|jC|d>?|d@dAdBCd d d d d d d d d | d:d:)5|d5|dd/ 5|d8d|dDd1d2|| d7d45d d d ||jAd;||||<=5|d"dEdFG|d@dAdBCd d d d d d d d d d d d d d d d d d  d d d | dHdI,d d d |d j3S#t0$rYywxYw#1swYxYw#1swYVxYw#1swYGxYw#1swY#xYw#1swY(xYw#1swYxYw#1swYxYw#1swYxYw#1swYxYw#1swYxYw#1swYxYw#1swYxYw#1swYTxYw#1swY xYw#1swY%xYw#1swY*xYw#1swY/xYw#1swY4xYw#1swY xYw#1swY:xYw#1swY5xYw)Kz@Build Prefab picker page: dropdown selector with per-tool forms.r)FetchOpenLinkSetState ShowToast) PrefabApp) ButtonColumnHeadingLabelMarkdownMutedPagePagesSelect SelectOptionTextarea)r)RESULTRxzX

prefab-ui not installed. Run: pip install fastmcp[apps]

zp-6 max-w-2xl mx-auto)gap css_class FastMCP AppszNNo UI tools found on this server. Use @app.ui() to register entry-point tools.N)rviewnamerqc2|jdxs|dS)Nrr)r.)rqs r _tool_titlez'_build_picker_html.._tool_title+sxx 0DL0rrVzp-8 max-w-2xl mx-autor()rTooluChoose a tool… activeToolz$event) placeholder on_change)rselected)level)rrr inputSchema __json_args__)rqrz$errorerror)variant_mode_ r ztext-sm text-muted-foreground)r_desc_shortz items-startu Show more ▾linkxsfullz text-muted-foreground p-0 h-auto)rsizeon_clickru Show less ▴form Argumentsz Edit as JSONr /api/launch)r- on_successon_error) on_submitT) fields_onlyLaunchsuccesssubmit)r button_typezUse formz{"key": "value"})rrrowsu5Generated by [Prefab](https://prefab.prefect.io) 🎨z(text-xs text-muted-foreground text-right)rqrHrFr)"prefab_ui.actionsrrrr prefab_ui.apprprefab_ui.componentsrrrrrrrrrrrprefab_ui.components.formr prefab_ui.rxrr ImportErrorrilenr.r model_fieldssplitjoinpost from_model)&toolsrrrrrrrrrrrrrrrrrrrr first_namerrqrdescrmodel form_body field_name json_bodyr input_mode_desc_max_lineslinesmd_css desc_staters& r_build_picker_htmlr s@jJJ+  3+  %< = N # ` > ~D9>>@@Ahv&J1 A!8 9T u:>Af  2&|R\B!&$'-"&v,%)&\Z%?!&  Ka) 3  J 7 L HH]39r/3xx /F/L" *4>-3TN "'"4"4J,.zNIj)#5!%'%8- %R\7C%dV_ "$$d+V] $ 4 0!@u:8$TV<+1$J$(IIe4D_.E$FE!&Jg!F$($@$*qM$J$,Uf$E$*(:06-119*f1M2T %&%K%A%)v$>$*qM$J$,TV$D$*(:06-119*g1N2T %&%K%?"G4Jf=!&7A!'A!G ' 1 = &$2,2)--5j&-I.P !""H"&*/**$1)2/7/?-5 +5+""!%4 H &$,,508!"":G70"&7A!'A!G ' 1 = &$.,2)--5j&-I.P !""H"&*/**$1)2/7/?-5 +5+""!))80B)*!" !'$,,508!"":G73>G.;++'8Z  C@ A :J > 5 : : < =$^%K$J%A$@%K$J%?$>"G!F8"H!G"":G772"H!G"":G773>=G.;]++)8 7' : 9s:P*P9 T=/ Q"Q2Q:&T= BT0. T# 8AT R  Q- Q ?Q-R  R$Q:R R T % T 0 S: R;R!$*R;R.-R;5S=T  S< S/$S*S/-S"S/ S<T T $T# , T08T=* P65P69QQ QQ T= Q*%Q--Q72R :R?RR R RT !R+&R;.R83R;;SSS T SS/"S,'S//S94S<<TT TT T T# #T- (T00T: 5T==UcK ddlm}ddlm} ||4d{\}}}|||4d{}|j d{|j d{}|jDcgc]}|jc}cdddd{cdddd{S#t$rgcYSwxYw777{7ecc}w747%#1d{7swYnxYwdddd{7y#1d{7swYyxYw#t$r'} tjd|d| gcYd} ~ Sd} ~ wwxYww)z5Return raw tool dicts from the MCP server at mcp_url.r ClientSessionstreamable_http_clientNzCould not list tools from : ) mcprmcp.client.streamable_httprr initialize list_toolsr model_dump Exceptionloggerdebug) mcp_urlrrreadwritersessionresultrexcs r _list_toolsrs%E)'226FtUA$T511W((***&113306 = 1  =211322  31*3=2311132222  1'"SEBC s5E B2 DCDC;CC;C C C#C $C6C  C C;CC; D,C-D1E2 C=E?CEDC;C C CC;DC& CC& "C;) D4C75D:E;D D D  D E D ED;5E6E;EEc K ddlm}ddlm}ddlm} ||4d{\}}}|||4d{}|jd{|j||d{} | jD]7} t| dd} | s| ccdddd{cdddd{Sdddd{dddd{y#t $rYywxYw77777O7@70#1d{7swY@xYw77#1d{7swYyxYw#t$r(} tjd|d|d | Yd} ~ yd} ~ wwxYww) z8Read an MCP resource by URI and return its text content.rrr)AnyUrlNtextzCould not read resource z from r)rrrrrrrr read_resourcecontentsgetattrr r r ) r urirrrrrrrrcontentrrs r_read_mcp_resourcers:%E# )'226FtUA$T511W((***&44VC[AA%G"7FD9D# 211322 /2132 31*A2311113222  /uF7)2cUKLsGEC D%C+D%DC-DC9C/C90C11"C9C9 D#C3$D( D%4C55D%9E:C9; DC7D D%DD%E C(%E'C((E+D%-D/C91C93D5D%7D9D ?DD DD%D"D D"D%!E"D%% E.E EEEc d|}|d}tjd5}|j|d}|j|j}dddt j d}|std |d |dd |jd }d |} tjd5}|j| d}|j|j} dddt j d } | std| d | dd | jd } | jdd jdd} d | }d| d}tjd||ii}ttjd|d|dz }|jr|j!d}||fSd|d}tjd5}|j|d}|j|j"}dddt%j&t)j*d5}|j-d}| td |j/j1}dddd!D]}j3d"|d#d$|d|d#}!|j5d||fS#1swYlxYw#1swYxYw#1swYxYw#1swYjxYw)%uDownload app-bridge.js and build an import-map that fixes Zod v4 on esm.sh. Returns ``(app_bridge_js, import_map_json)`` where *import_map_json* is a JSON string ready to embed in a ``.@rz"User server did not start on port zFastMCP dev UI at warningzwebsockets-sansio)rport log_levelwscyrCrOrOrrz-run_dev_apps.._body..&srcvKtjdd{tjy7w)Ng?)rSr webbrowserr4)dev_urlsr _open_browserz2run_dev_apps.._body.._open_browser(s*--$ $ $ OOG $ %s 979rE)socketAF_INETAF_INET6 SOCK_STREAM connect_exOSErrorr rrexitinforrW_EXT_APPS_VERSIONrfrr-rruvicornConfigServerinstall_signal_handlersrSgatherserve)rrlabelflagin_use_targetsfamilyaddrsrKrIr]readydev_appconfigserverrrrrrhrr rr user_procs r_bodyzrun_dev_apps.._bodys |\ 2 x ." D%F ;&^^k4%89__udAq&9:d{oodAq'9:<!>>D$<8: !) vv/A/ABa<<-2%)F!CB2C!) D6E7+& 9; ?" B  3H:SAB 89 - &t  0H /0 * &  .o->m L 'w==!CH:NO O ( 23 ]NKM9  "  '*6& %nnV\\^]_===oCB * >2 >sA/I3H/H"'H//I2H/:I?A6I5H?6III/I0B,III"H, 'H// H<8I;H<<IIIIctjdjtjj y)Nz uvicorn.error)logging getLoggersetLevelCRITICALcancel)tasksr _on_signalz run_dev_apps.._on_signal5s- /*33G4D4DE rrrE)rSrT ensure_futurerradd_signal_handlersignalSIGINTSIGTERMCancelledErrorremove_signal_handler returncoderkillpggetpgidpidkillProcessLookupErrorPermissionErrorwait) rrrrrrhrrVrrr rrs `````` @@@@r run_dev_appsr'su" d? $q $'vRz .  d? $q #vRz * 48IQ>Q>n  # # %D   )D ||w  z:  ;#  <<7 "  & &v}} 5  & &v~~ 6  Y%9%9%A !<<7*IIbjj7HNN$.." " "&B    ! !   '8 !  ! " <<7 "  & &v}} 5  & &v~~ 6  Y%9%9%A !<<7*IIbjj7HNN$&8 !  !.." " "&B sCLF;F9F;AL9A%GL1G92L9F;;GG;GG;G63L5G66L;A LA%KLK$!L#K$$L:K=;LL)rrrFr)rarrbbytesrcrrFrG)rirrFr)rqrHrFr)rrrrHrFz type[Any])rrJrFr)r rrFrJ)r rrrrFz str | None)r9rr:rrFztuple[str, str]) r rrKrr]rrrrhrrFr) rrrrIrrrrrFzasyncio.subprocess.Process)r)rrrrrFr)rrrrIrrIrrrrrhrrFrG)r1s0#   " ,&II#0 H  "X$X$v * S rwzrjBYRxi=b&:l* l*l*l*^  X XXX X  X  XH          F*T#T#T# T#  T#  T#T# T#r