kKj,dZddlZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZmZddlZddlZddlmZddlmZddlmZddlZdd lmZdd lmZdd lmZmZm Z dd l!m"Z"dd l#m$Z$ddl%m&Z&ddl'm(Z(m)Z)ddl*m+Z+m,Z,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3e/dZ4eZ5ejlddejnedZ8dZ9de:de;e:e:ffdZe8j~d d!d"ee@ej$d#d$%ffd&ZAejld'd()ZBeBj~ dddddddddd*dd d+ d,e:dzd-ee=e dzej$d.d/%fd0ee=e:dzej$d1d2%fd3ee:dzej$d4d5%fd6eeCdzej$d7d8%fd9eeCdzej$d:d;%fd%fd?ee dzej$d@dA%fdBee dzej$dCdD%fdEee@ej$dFdGdHIfdJee=e dzej$dKdL%fdMee@ej$dNdOgdP)fddfdQZDeBj~dRdSd*dTd*dUd,e:dVeeCej$dWdX%fdYeeCej$dZd[%fdEee@ej$dFdHd\]fd^ee:ej$d_d`%fdaee@ej$dbdcdd]fddfdeZEe8j~ ddddddd ddddd d d dd d dfd,e:dzdge:dheejdzej$didjgdk)fd^ee:dzej$d_dl%fdmeeCdzej$dndogdp)fdqee:dzej$drds%fdteedudzej$dvdwgdx)fdyee@ej$dzd{%fd%fd0ee=e:dzej$d1d2%fdBee dzej$dCdD%fd?ee dzej$d@dA%fd|ee@ej$d}d~%fdee@ej$dd%fdEee@ej$dFdHd]fdJee=e dzej$dKdL%fdee@ej$dd%fdMee@ej$dNdOgdP)fddf&dZe8j~ dddddddd dd,e:dzdee+dzej$ddgd)fdee dzej$ddgd)fd%fd0ee=e:dzej$d1d2%fdBee dzej$dCdD%fd?ee dzej$d@dA%fdee@ej$dd%fddfdZGejldBd)ZHeHj~ ddee:dzej$d%fdee:dzej$d%fd|ee@ej$d%fddfdZIe8jeBe8jeHe8je$e8je&e8je de8jede8jede8je"de8jeeJdk(re8yy)z!FastMCP CLI tools using Cyclopts.N)contextmanagerPath) AnnotatedLiteral) Parameter)Console)Table)run)auth_app) call_commanddiscover_command list_command)generate_cli_command) install_app) tasks_app)is_already_in_uv_subprocessload_and_merge_config) InspectFormat format_infoinspect_fastmcp) get_logger)MCPServerConfig)check_for_newer_versionclifastmcpzBFastMCP - The fast, Pythonic way to build MCP servers and clients.)negative)namehelpversiondefault_parameterctjdk(r&dD] } tj|dgdd|cSyy#tjt f$rY@wxYw)z5Get the correct npx command for the current platform.win32)znpx.cmdznpx.exenpxz --versionT)checkcapture_outputNr%)sysplatform subprocessr CalledProcessErrorFileNotFoundError)cmds `/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/fastmcp/cli/cli.py_get_npx_commandr/1s_ ||w0C [1dS 1  113DE  s;AAenv_varreturnc<d|vr*tjdtjd|j dd\}}|j s*tjdtjd|j |j fS)z6Parse environment variable string in format KEY=VALUE.=z6Invalid environment variable format. Must be KEY=VALUEz8Invalid environment variable format. KEY cannot be empty)loggererrorr(exitsplitstrip)r0keyvalues r._parse_env_varr<?sn ' MN  sA&JC 99; OP  99; %%argsc#K|Ctjdd} tjdg|t_d|t_ydy#|t_wxYww)a:Temporarily replace sys.argv if args provided. This context manager is used at the CLI boundary to inject server arguments when needed, without mutating sys.argv deep in the source loading logic. Args are provided without the script name, so we preserve sys.argv[0] and replace the rest. Nr)r(argv)r>originals r. with_argvrBKsN 88A;  +d+CH CH  CHsA#A A AAF)copyrCz--copyz%Copy version information to clipboard)r ctjtjj dt j t j ttjxsdjjdd}tjd}|jdd |jd d |jD]3\}}|j|d zt!|j#d d5|rqt%ddd}|j'5}|j)|dddt+j,j/t0j)dyt0j)|t3x}rCt0j)t0j)d|dt0j)dyy#1swYxYw)z1Display version information and platform details.mcp.r4)zFastMCP versionz MCP versionzPython versionPlatformzFastMCP root path)rr4)paddingboldleft)stylejustifycyanright:  NF)fileforce_terminallegacy_windowsu:[green]✓[/green] Version information copied to clipboardu3[bold]🎉 FastMCP update available:[/bold] [green]z[/green]z-[dim]Run: pip install --upgrade fastmcp[/dim])r __version__ importlibmetadatar!r)python_versionr__file__resolveparentsr grid add_columnitemsadd_rowstrreplacer captureprint pypercliprCgetconsoler)rCinfogkv plain_consolerb newer_versions r.r!r!bs{#.. ))11%8"113%%'!'"2"2"9c:BBDLLQO  D  6"ALLvvL.LLvwL/ 1 !c'3q6>>$45 T%PUV  " " $    "%w{{}% RS a45 5= 5 MMO MMEm_T\]  MMI J 6% $s 0G((G1devz!Development tools for MCP servers)rr T) with_editable with_packagesinspector_versionui_port server_portpythonwith_requirementsprojectreload reload_dirmodule server_specrnz--with-editablez\Directory containing pyproject.toml to install in editable mode (can be used multiple times)roz--withz;Additional packages to install (can be used multiple times)rpz--inspector-versionz#Version of the MCP Inspector to userqz --ui-portzPort for the MCP Inspector UIrrz --server-portz'Port for the MCP Inspector Proxy serverrsz--pythonz(Python version to use (e.g., 3.10, 3.11)rtz--with-requirementsz.Requirements file to install dependencies fromruz --projectz2Run the command within the given project directoryrv--reloadz7Enable auto-reload on file changes (enabled by default) --no-reload)r rrw --reload-dirz=Directories to watch for changes (default: current directory)rx--modulez-mzMRun a Python module (python -m ) instead of importing a server objectc K t|||xsg|||r|D cgc] } t| c} nd|\} }|s| jj}tjd| jj| jj||d | s*tjdt j d| J| s"| jjd{i}|rt||d<|rt||d <t}|s*tjd t j dd }|r|d |z }d d|dg}| r|j!d| r6|j!d| r#| D]}|j#dt|g | jj%|}t't(j*j-|zddiz}t/j0||g|d|}t j |j2ycc} w#t$rt j dYwxYw7j#t.j4$r`}tjdt|t||j2dt j |j2Yd}~yd}~wt$r:tjddt|it j dYywxYww)zRun an MCP server with the MCP Inspector for development. Args: server_spec: Python file to run, optionally with :object suffix, or None to auto-detect fastmcp.json N)rsrortrueditableportr4zStarting dev server)ryrnrorqrrextraNo configuration available CLIENT_PORT SERVER_PORTzbnpx not found. Please ensure Node.js and npm are properly installed and added to your system PATH.z@modelcontextprotocol/inspector@rr --no-bannerr}rzr|FASTMCP_UV_SPAWNED1Tr&envzDev server failed)rRr6 returncodeznpx not found. Please ensure Node.js and npm are properly installed and added to your system PATH. You may need to restart your terminal after installation.rR)rr` deploymentrr,r(r7r5debug environmentr dependenciesr6source load_serverr/appendextend build_commanddictosenvironr^r*r rr+)ryrnrorprqrrrsrtrurvrwrxpconfigenv_varsnpx_cmd inspector_cmd fastmcp_cmddir_pathuv_cmdrprocesses r. inspectorrsp3 '-2/8Em4mc!fm44   ++00K  LL&#//88#//<<&   J LL5 6 HHQK!!!--++- - - &)'lH] # &)+&6H] ##$ LL1  HHQK9  q!2 34 4M!%mD     z *    z * *H&&H 'FG!+##11+>2::##%&15I34OO.. m -f -  ##$]5   . .`  ( (  K(Qll      "3{+,   sL H*H%&H*AL AI%I&D>I$L %H**I L  I  L IL%AK;L ALL LL i@iz 127.0.0.1mcp_portdev_portrvhost log_panelrz --mcp-portzPort for the user's MCP serverrz --dev-portzPort for the FastMCP dev UIz*Auto-reload the MCP server on file changes)rr r--hostzHost to bind torz --log-panelz--no-log-panelz#Log panel feature in FastMCP dev UIcK ddl}ddlm}|||||||d{y#t$r-tjdt j dYRwxYw7>w)aPreview a FastMCPApp UI in the browser. Starts the MCP server from SERVER_SPEC on --mcp-port, launches a local dev UI on --dev-port with a tool picker and AppBridge host, then opens the browser automatically. Requires fastmcp[apps] to be installed (prefab-ui). rNzNfastmcp dev apps requires prefab-ui. Install with: pip install 'fastmcp[apps]'r4) run_dev_appsr) prefab_ui ImportErrorr5r6r(r7fastmcp.cli.apps_devr)ryrrrvrrrrs r.appsrSsjd2      \   s/A %A AA 3AA AA ) transportrrpath log_level no_bannerrsrorurt skip_sourceskip_envrvrw statelessrx server_argsr --transportz-tzTransport protocol to usez>Host to bind to when using http transport (default: 127.0.0.1)r--portz-pz9Port to bind to when using http transport (default: 8000)r--pathzZThe route path for the server (default: /mcp/ for http transport, /sse/ for sse transport)r)DEBUGINFOWARNINGERRORCRITICAL --log-levelz-lz Log levelrrzDon't show the server bannerrz --skip-sourcezBSkip source preparation step (use when source is already prepared)r --skip-envzRSkip environment configuration (for internal use when already in a uv environment)z5Enable auto-reload on file changes (development mode)r --statelessz>Run in stateless mode (no session, used internally for reload)c K|r|*tjdtjdg}||j d||j d||j d||j d|r(tj dd j |d d}| sCts9d d lm }|||xsd| | }dg}|j||k7r |j}| rdd|ddg}|r|jd|g|r|j d||j d|r"|j d|j||||}tj||dd{ytj|||rt|ydy| s trd} t!|||xsg| | ||||||r t|nd \}}||nj$j&}||nj$j(}||nj$j*}||nj$j,}||nj$j.}|xsj$j0}|r|nt2j4j6 }tj9d|||||||r t|ngd| rl|dk(rtj dnPdd|g}|r|jd|g|d k7rH||jd|g||jdt;|g||jd|g|r|jd|g|r|j d|j d|j d!dg}j<j||k7xr| } | r|j d|r"|j d|j|| r|j<j|}|d"v}!tj|||!d{ydg}j<j||k7xr| } | rgdd|g}"|r|"jd|g|d k7rH||"jd|g||"jdt;|g||"jd|g|r|"jd|g|r|"j d|r|"j d!|"j d|r"|"j d|"j||j<j|"}#t>j@d#d$iz}tj9d%d&j |# tCjD|#d|'}$tj|$jFy tjL|||||||r t|ng| | |* d{y7#t"$rtjdYAwxYw7#tBjH$rZ}%tjKd(|%|t;|%|%jFd)tj|%jFYd}%~%yd}%~%wwxYw7#tN$rE}%tjKd(|%|t;|%d+tjdYd}%~%yd}%~%wwxYww),aRun an MCP server or connect to a remote one. The server can be specified in several ways: 1. Module approach: "server.py" - runs the module directly, looking for an object named 'mcp', 'server', or 'app' 2. Import approach: "server.py:app" - imports and runs the specified server object 3. URL approach: "http://server-url" - connects to a remote server and creates a proxy 4. MCPConfig file: "mcp.json" - runs as a proxy server for the MCP Servers in the MCPConfig file 5. FastMCP config: "fastmcp.json" - runs server using FastMCP configuration 6. No argument: looks for fastmcp.json in current directory 7. Module mode: "-m my_module" - runs the module directly via python -m Server arguments can be passed after -- : fastmcp run server.py -- --config config.json --debug Args: server_spec: Python file, object specification (file:obj), config file, URL, or None to auto-detect Nz2A module name is required when using --module / -mr4rrrrzOptions z, zL are ignored in module mode (-m). The module manages its own server startup.r) UVEnvironment)rsr requirementsrutestrr r}r{rrrz--T) reload_dirsis_stdio)env_command_builder extra_args) rsrortrurrrrrrzRunning server or client)ryrrrrrrrssez--reload is not supported with SSE transport (sessions are lost on restart). Use streamable-http transport instead, or use --no-reload. Running without reload.stdior)rNrrzRunning command: rQrzFailed to run: )ryr6r) ryrrrrrr show_bannerrrryr6)(r5r6r(r7rwarningjoinr6fastmcp.utilities.mcp_server_config.v1.environments.uvrrr run_modulerun_with_reloadrun_module_commandlistrr,rrrrrrr>rsettingsshow_server_bannerrr`rrrr*r rr+ exception run_command Exception)&ryrrrrrrrsrorurtrrrvrwrrxrignored_options env_builderrrtest_cmd reload_cmdrfinal_transport final_host final_port final_pathfinal_log_levelfinal_server_argsfinal_no_bannerneeds_uvr inner_cmdr-rrs& r.r r sKJ   LLM N HHQK&(   " "= 1    " "8 ,    " "8 ,    " "8 ,  NN499_567CD    ; =  *2d. C xH  *h6!// #UK]SJ!!=)"<=!!-0&!!,/!!$'!!+.&(4 ,, T   %%  +,7tK( >B .03 '-2/-8[)d   $* 0A0A0K0K)v/@/@/E/EJ)v/@/@/E/EJ)v/@/@/E/EJ* 0A0A0K0K$=v'8'8'='= (8(8(K(K$K LL"&((6G4 12R   e # NN* $UK8J!!=/"BC'))%%x&<=)%%xZ&AB)%%x&<=!!=/"BC!!-0   m ,   m ,xH""00:hFWx< !!,/ !!$'!!"34#//==jI &/9H,, X   xH!!//9XEVh,H{3     m_= > g %%  (J!78%  (C O!<=%  (J!78    m_= >    ] +    ] +&    T "   . /  ..y9jj0#66  (#89 # nnS#>G HHW'' ( (('))7HD!23b //'#   [ >   ^ d,, #   !!%#. V"#,,   HHQ\\ " " #     !!%#. V   HHQKK sE<[4>X??[4?*X )I[49X.:E[47X1[40Z#Z!Z#[4 X+'[4*X++[41ZAZ[4Z[4!Z## [1,;[,'[4,[11[4)formatoutputrsrorurtrr--formatz-fzXOutput format: fastmcp (FastMCP-specific) or mcp (MCP protocol). Required when using -o.r--outputz-ozbOutput file path for the JSON report. If not specified, outputs to stdout when format is provided.cX K|s trd} t|||xsg||\}}|jdrc|a tt |5} t j | } dddd vr*tjdtjddg} jj| | k7xr| } | rd d |d g} |r| jd |j g|r| jd t#|gddl}|jj| }t&j(ddiz}|j*|d|}tj|j,tj/d|||r t#|ndd |s*tjdtjd|J|j0j3d{}t5|d{}|rA|s?t6j9dt6j9dtjd|t6j9t6j9dt6j9d|j:|j<r"t6j9d|j<|j>r"t6j9d|j>|j@r+t6j9dtC|j@t6j9d|jD|jFr"t6j9d|jFt6j9t6j9dt6j9d tC|jHt6j9d!tC|jJt6j9d"tC|jLt6j9d#tC|jNt6j9t6j9d$t6j9d%|jPt6j9d&|jRt6j9t6j9d'ytU|||d{}|r|jVjYdd(|jd)5} | j[|dddtj]d*|t6j9d+|d,t6j9d-|j:d.t6j9d/|j yt6j9|j_d0y#1swYtxYw#t jtf$rYewxYw#t$rtjdYwxYw7E757C#1swYxYw#t`$r]}tjcd1||t#|d2t6j9d3|tjdYd}~yd}~wwxYww)4aInspect an MCP server and display information or generate a JSON report. This command analyzes an MCP server. Without flags, it displays a text summary. Use --format to output complete JSON data. Examples: # Show text summary fastmcp inspect server.py # Output FastMCP format JSON to stdout fastmcp inspect server.py --format fastmcp # Save MCP protocol format to file (format required with -o) fastmcp inspect server.py --format mcp -o manifest.json # Inspect from fastmcp.json configuration fastmcp inspect fastmcp.json fastmcp inspect # auto-detect fastmcp.json Args: server_spec: Python file to inspect, optionally with :object suffix, or fastmcp.json T)rsrortruz.jsonN mcpServersz4MCPConfig files are not supported by inspect commandr4rrinspectrrrrrrrzInspecting server)ryrrrrzG[bold red]Error:[/bold red] --format is required when using -o/--outputzL[dim]Use --format fastmcp or --format mcp to specify the output format[/dim]z[bold]Server[/bold]z Name: z Version: z Website: z Icons: z Generation: z Instructions: z[bold]Components[/bold]z Tools: z Prompts: z Resources: z Templates: z[bold]Environment[/bold]z FastMCP: z MCP: z?[dim]Use --format \[fastmcp|mcp] for complete JSON output[/dim])r[exist_okwbz,Server inspection complete. Report saved to u?[bold green]✓[/bold green] Server inspection saved to: [cyan][/cyan]z Server: [bold]z[/bold]z Format: zutf-8zFailed to inspect server: ru3[bold red]✗[/bold red] Failed to inspect server: )2rrendswithopenrjsonloadr5r6r(r7JSONDecodeErrorr,rrrr;r`r*rrr rrrrrrfrcrr! website_urliconslenserver_generation instructionstoolsprompts resources templatesfastmcp_version mcp_versionrparentmkdirwritergdecoderr)ryrrrsrorurtrrfdatarrinspect_commandr*r-rrserverrgformatted_jsonrs r.rrs}Z.03 '-2/       (V^ ${+,99Q   " "JF #< =   ..?jj0#66 *..Dc: ##$ LL&%+c&k \ LL5 6 HHQK!!!}}0022%V,, & MMY  MM^  HHQK > MMO MM/ 0 MM,TYYK8 9|| 0?@ 01A1A0BCDzz 0TZZ0ABC MM,T-C-C,DE F   01B1B0CDE MMO MM3 4 MM,S_,=> ? MM,S->,?@ A MM,S-@,AB C MM,S-@,AB C MMO MM4 5 MM,T-A-A,BC D MM,T-=-=,>? @ MMO MMR   +664@@  MM  t  <T"a'# KKFvhO P MMQRXQYY`a  MM,TYYKw? @ MMJv||n5 6 MM.//8 9E-, ((*;<     ^3-fA#"  ( ,*Q    KA3OP   sZ**XW&W'6W&C;Z*A Y&X+'Y9X.:K#YZ*Y.X1/4Y#X45A>Y3Z*4$YZ*W#W&&X?XXXX($Z*'X((Z*+Y.Y1Y4X>9Y Z' AZ"Z*"Z''Z*zManage FastMCP projects config_pathz'Path to fastmcp.json configuration file output_dirz1Directory to create the persistent environment inz)Skip source preparation (e.g., git clone)c @Kddlm}|*tjdt j d|dt j}|r$t|}tjd|n*tjdt j d|J||}|js-tjd|t j d|J||} t j|}|j|| d{tjd |d |d |d y7$#t$rO}tjd|tjd|t j dYd}~yd}~wwxYww)a Prepare a FastMCP project by creating a persistent uv environment. This command creates a persistent uv project with all dependencies installed: - Creates a pyproject.toml with dependencies from the config - Installs all Python packages into a .venv - Prepares the source (git clone, download, etc.) unless --skip-source After running this command, you can use: fastmcp run --project This is useful for: - CI/CD pipelines with separate build and run stages - Docker images where you prepare during build - Production deployments where you want fast startup times Example: fastmcp project prepare myserver.json --output-dir ./prepared-env fastmcp run myserver.json --project ./prepared-env rrNzbThe --output-dir parameter is required. Please specify where to create the persistent environment.r4zUsing configuration from zxNo configuration file specified and no fastmcp.json found. Please specify a configuration file or create a fastmcp.json.zConfiguration file not found: )rr u>[bold green]✓[/bold green] Project prepared successfully in z7! You can now run the server with: [cyan]fastmcp run z --project rzFailed to prepare project: u4[bold red]✗[/bold red] Failed to prepare project: )pathlibrr5r6r(r7r find_configr`rgexists from_filepreparerfrcr) r r rr found_config config_file output_pathrrs r.rrsD  I   &224 l+K KK3K=A B LLP  HHQK  "" "{#K     5k]CD   !! !z"K **;7nn#"    L[MZ##.-{:,g O    21#67 LQCPQ  sCC.F1+EE#EFE F AFFFFr)rcalldiscoverz generate-cli__main__)N)NNF)K__doc__importlib.metadatarVimportlib.utilrrr)r*r( contextlibrrrtypingrrcycloptsrdr rich.consoler rich.tabler r fastmcp.clir rfastmcp.cli.authr fastmcp.cli.clientr rrfastmcp.cli.generaterfastmcp.cli.installrfastmcp.cli.tasksrfastmcp.utilities.clirrfastmcp.utilities.inspectrrrfastmcp.utilities.loggingr#fastmcp.utilities.mcp_server_configrfastmcp.utilities.version_checkrr5rfApprUappr/r`tupler<rrBcommandboolr!dev_appintrr TransportTyper project_appr__name__rr=r.r6sQ '  %% )%KK5+'T 1?C E  )hll  M   ,   &C &E#s(O &DI$,  &K  8*QR T &K &KT (,,E(K L "          _t T T o   S D X   ! d  !6  !. d  0  /< d  :  =J  d  ;   KX! t  !A  Yf t  E  gt   J"   uD T T P  ER  d#`   S` aD      OBB  1  B  .  B"   "=   #B2   "   3B@  %6  ABP QBBJ"y               _ytyy  4'&,  y  d  Q   y"  d D!L   #y0  d  m   1y>?@4G&  ?yL =/MN PMyT  d  ;   Uyb S D X  cyn t  E  oy|! t  !A  }yJ  U  KyX  e  Yyf   "H   gyv T T P  wyD  Q  EyR  d#`   Sy` ay yx "j      ejtj d#k   j  t d#u   j"  d  ;   #j0 S D X  1j< t  E  =jJ! t  !A  KjX  e  Yjf gj j\hll 0IJ     T d  IJ LT  d  ST V T  KL NT TTp G K K I Lv & Lv & : . ~ 6 H zEr=