+ Q(iv"Rt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RI H t ^RI H t ^RI HtHt^RIt^RIt^RIHt^RIHt^RIHt^RIt^RIHt^R IHt^R IHtHtH t ^R I!H"t"^R I#H$t$^R I%H&t&^RI'H(t(H)t)^RI*H+t+H,t,H-t-^RI.H/t/^RI0H1t1^RI2H3t3]/!R4t4]!4t5]Pl!RR]Pn]!RJR7R7t8Rt9RRlt:] RRl4t;]8PxRR/RR ll4t=]Pl!R!R"R#7t>]>PxRKR$RR%RR&RR'RR(RR)RR*RR+RR,R-R.RR/R/ R0R1lll4t?]8PxRKR2RR3RR4RR5RR6RR7RR)RR%RR+RR*RR8RR9RR,RR.RR:RR/R/R;R<lll4t]8PxRKR=RR>RR)RR%RR+RR*RR9R/R?R@lll4t@]Pl!R+RAR#7tA]APxRLRBRCll4tB]8Py]>4]8Py]A4]8Py]$4]8Py]&4]8Py] RDRE7]8Py]RFRE7]8Py]RGRE7]8Py]"RHRE7]8Py]4]CRI8Xd ]8!4R#R#)Mz!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_versionclifastmcpzFFastMCP 2.0 - The fast, Pythonic way to build MCP servers and clients.)negative)namehelpversiondefault_parameterc\PR8Xd*RF!p\P!VR.RRR7Vu# R#R# \PdKAi;i)z5Get the correct npx command for the current platform.win32npxz --versionT)checkcapture_outputN)znpx.cmdznpx.exer#)sysplatform subprocessr CalledProcessError)cmds U/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/fastmcp/cli/cli.py_get_npx_commandr,1sY ||w0C [1dS 1  00  sAAAcRV^8dQhR\R\\\3,/#)env_varreturn)strtuple)formats"r+ __annotate__r4?s"&&C&E#s(O&cRV9d,\PR4\P!^4VP R^4wrVP 4VP 43#)z6Parse environment variable string in format KEY=VALUE.=z6Invalid environment variable format. Must be KEY=VALUE)loggererrorr&exitsplitstrip)r/keyvalues& r+_parse_env_varr??sK ' MN  sA&JC 99; %%r5cHV^8dQhR\\,R,/#)r.argsN)listr1)r3s"r+r4r4IsDI$r5c#"VeM\PR,p\P^,.VO\nRxV\nR#RxR# T\ni;i5i)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. N:NNN)r&argv)rAoriginals& r+ with_argvrFHsM 88A;  +d+CH CH  CHsA)'AA) A&&A)copyFcjV^8dQhR\\\P!RRR73,/#)r.rGz--copyz%Copy version information to clipboardr)rboolcycloptsr)r3s"r+r4r4`s6&K&K  8*QR T &Kr5c RR\PR\PP R4R\ P !4R\ P !4R\\P;'gR4P4P^,/p\P!RR7pVPR R R 7VPR R R 7VP4F7wr4VPVR,\!V4P#RR44K9 V'd|\%RRRR7pVP'4;_uu_4pVP)V4RRR4\*P,!XP/44\0P)R4R#\0P)V4\34;p'dE\0P)4\0P)RV R24\0P)R4R#R# +'giL;i)z1Display version information and platform details.zFastMCP versionz MCP versionmcpzPython versionPlatformzFastMCP root path.)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__ importlibmetadatarr'python_versionr__file__resolveparentsr grid add_columnitemsadd_rowr1replacercaptureprint pypercliprGgetconsoler)rGinfogkv plain_consolerk newer_versions$ r+rr_s 7..y))11%8(113H%%'T'"2"2"9"9c:BBDLLQO  D  6"ALLvvL.LLvwL/  !c'3q6>>$45 T%PUV  " " $ $    "%w{{}% RS a45 5= 5 MMO MMEm_T\]  MMI J 6% $s H H& devz!Development tools for MCP serversrr with_editable with_packagesinspector_versionui_port server_portpythonwith_requirementsprojectreloadT reload_dirmodulecV^8dQhR\R,R\\\,R,\P !RRR73,R\\\,R,\P !RR R73,R \\R,\P !R R R73,R \\ R,\P !RRR73,R\\ R,\P !RRR73,R\\R,\P !RRR73,R\\R,\P !RRR73,R\\R,\P !RRR73,R\\\P !RRRR 73,R!\\\,R,\P !R"R#R73,R$\\\P !R%R&.R'R(73,R)R/ #)*r. server_specNrxz--with-editablez\Directory containing pyproject.toml to install in editable mode (can be used multiple times)rIry--with;Additional packages to install (can be used multiple times)rzz--inspector-versionz#Version of the MCP Inspector to user{z --ui-portzPort for the MCP Inspector UIr|z --server-portz'Port for the MCP Inspector Proxy serverr}--python(Python version to use (e.g., 3.10, 3.11)r~--with-requirements.Requirements file to install dependencies fromr --project2Run the command within the given project directoryr--reloadz7Enable auto-reload on file changes (enabled by default) --no-reload)rrr --reload-dir=Directories to watch for changes (default: current directory)r--module-mMRun a Python module (python -m ) instead of importing a server objectrwr0)r1rrBrrKrintrJ)r3s"r+r4r4sSt 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` ar5c "\TTT;'g.TTV'dVU u.uFp \V 4NK up MRVR7wrV'gV PPp\PRRTRX PPRT PPRTRT/R 7T 'g,\PR 4\ P !^4T fQhT 'g#T PP4GRjxL /pT'd\T4TR &T'd\T4TR &\4pT'g,\PR 4\ P !^4RpT'd TRT 2, pRRTR.pT 'dTP!R4T 'd?TP!R4T 'd&T FpTP#R\T4.4K! T PP%T4p\'\(P*P-44T,RR/,p\.P0!TT.TORTR7p\ P !TP24R#uup i \d\ P !^4ELMi;iEL \.P4dep\PRR\T4R\T4RTP2/R 7\ P !TP24Rp?R#Rp?i\d=\PRR\T4/R 7\ P !^4R#i;i5i)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)r}ryr~reditableportzStarting dev serverrrxryr{r|extraNo 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-bannerrrrFASTMCP_UV_SPAWNED1Tr$envzDev server failedrZr9 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.)rr1 deploymentrFileNotFoundErrorr&r:r8debug environmentr dependenciesr9source load_serverr,appendextend build_commanddictosenvironrhr(r rr))rrxryrzr{r|r}r~rrrrpconfigenv_varsnpx_cmd inspector_cmd fastmcp_cmddir_pathuv_cmdrprocesses&$$$$$$$$$$$ r+ inspectorrsp3 '--2/8Em4mc!fm44  ++00K  LL ; V//88 V//<< w ;   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(Qall      "3{+,   sM8J J J+J #A M8-J758J7.J7 J4 J7J70AJ7J7J78J7B4J7M8J !J1-M80J11M84J77M5 AL+%M8+ M589M51M84M55M8 transporthostrpath log_level no_banner skip_sourceskip_env statelessc*NV^8dQhR\R,R\R\\PR,\P !RR.RR73,R \\R,\P !R R R 73,R \\ R,\P !RR.RR73,R\\R,\P !RRR 73,R\\R=,R,\P !RR.RR73,R\\\P !RRR 73,R\\R,\P !RRR 73,R\\\,R,\P !RR R 73,R!\\R,\P !R"R#R 73,R$\\R,\P !R%R&R 73,R'\\\P !R(R)R 73,R*\\\P !R+R,R 73,R-\\\P !R.R/R0R173,R2\\\,R,\P !R3R4R 73,R5\\\P !R6R7R 73,R8\\\P !R9R:.R;R73,Rr.rN server_argsr --transportz-tzTransport protocol to userwr--hostz>Host to bind to when using http transport (default: 127.0.0.1)rIr--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 --log-levelz-lz Log levelrrzDon't show the server bannerr}rrryrrrrrr~rrrz --skip-sourcezBSkip source preparation step (use when source is already prepared)r --skip-envRSkip environment configuration (for internal use when already in a uv environment)rrrz5Enable auto-reload on file changes (development mode))rrrrrr --statelessz>Run in stateless mode (no session, used internally for reload)rrrrr0)DEBUGINFOWARNINGERRORCRITICAL) r1r run_module TransportTyperKrrrrJrBr)r3s"r+r4r4Qs\sstss  4'&,  s  d  Q   s"  d D!L   #s0  d  m   1s>?@4G&  ?sL =/MN PMsT  d  ;   Usb S D X  csn t  E  os|! t  !A  }sJ  U  KsX  e  Ysf   "H   gsv T T P  wsD  Q  EsR  d#`   Ss` asr5ct"V'EdVf,\PR4\P!^4.pV'dVP R4V'dVP R4V'dVP R4V'dVP R4V'd)\P RRP V4 R 24RpV 'gR\4'gB^R IH pT!TT;'gRV V R 7pR .pVPV4V8wd VPpV 'dR RVRR.pV'dVPRV.4V'dVP R4VeVP R4V'd#VP R4VPV4Ve V!V4p\P!VVRR7GRjxL R#\P!TTV'd \V4MRR7R#V 'g\4'dRp \!TTT;'g.T T TTTTTV'd \V4MRR7 wppT;'gXP$P&pT;'gXP$P(pT;'gXP$P*pT;'gXP$P,pT;'gXP$P.pT;'gXP$P0pV'dTM\2P4P6'*p\P9RRTRTRTRTRTRTR V'd \V4M./R!7V 'EdVR"8Xd\P R#4EMR RV.pV'dVPRV.4VR$8wd[V'dVPRV.4V'dVPR\;V4.4V'dVPRV.4V'dVPRV.4V'dVP R4VP R4VP R%4R .pXP<PV4V8g;'dV '*p V 'dVP R4V'd#VP R4VPV4V 'dVP<PV4pVR/9p!\P!VVV!R7GRjxL R#R .pXP<PV4V8g;'dV '*p V 'EdR RV.p"V'dV"PRV.4VR$8wd[V'dV"PRV.4V'dV"PR\;V4.4V'dV"PRV.4V'dV"PRV.4V'dV"P R4V"P R4V'd#V"P R4V"PV4VP<PV"4p#\>P@R&R'/,p\P9R(R)P V#4 24\BPD!V#RVR*7p$\P!V$PF4R#\PL!TTTTTTV'd \V4M.V'*V VR.7 GRjxL R#ELf \"d\P!^4ELi;iEL5 \BPHd_p%\PKR+T% 2RTR,\;T%4R-T%PF/R!7\P!T%PF4Rp%?%R#Rp%?%ii;iL \NdIp%\PKR+T% 2RTR,\;T%4/R!7\P!^4Rp%?%R#Rp%?%ii;i5i)0ayRun 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 / -mrrrrzOptions z, zL are ignored in module mode (-m). The module manages its own server startup.) UVEnvironment)r}r requirementsrtestrr rrrrrz--T) reload_dirsis_stdio)env_command_builder extra_args) r}ryr~rrrrrrrzRunning server or clientrrrrrrrrssez--reload is not supported with SSE transport (sessions are lost on restart). Use streamable-http transport instead, or use --no-reload. Running without reload.stdiorrrzRunning command: rYrzFailed to run: r9r) rrrrrrr show_bannerrr)rN)(r8r9r&r:rwarningjoinr6fastmcp.utilities.mcp_server_config.v1.environments.uvrrrrrun_with_reloadrun_module_commandrBrrrrrrrrrArsettingsshow_server_bannerrr1rrrr(r rr) exception run_command Exception)&rrrrrrrr}ryrr~rrrrrrrignored_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 Ps<Jv   LLM N HHQK&(   " "= 1   " "8 ,   " "8 ,   " "8 ,  NN499_567CD    ; = =  *22d. C xH  *h6!// #UK]SJ!!=)"<=!!-0&!!,/!!$'!!+.&(4 ,, T   %%  +,7tK(T .003 '--2/-8[)d   " >>6#4#4#>#>O//**//J//**//J//**//J>>6#4#4#>#>O#==v'8'8'='= (8(8(K(K$K LL" ;  J J J  6G4 12R  v e # NN* $UK8J!!=/"BC')%%x&<=%%xZ&AB%%x&<=!!=/"BC!!-0   m ,   m ,xH""00:hFWWx< !!,/ !!$'!!"34#//==jI &/9H,, X   xH!!//9XEVVh,Hx{3     m_= > g %  (J!78  (C O!<=  (J!78    m_= >    ] +&    T "   . /  ..y9jj0#66  (#89 # nnS#>G HHW'' ( (('))7HD!23b //'#   O >   V `,, #   !!%!;SV !,,   HHQ\\ " " #     !!%!;SV   HHQKK sA`8`8`87`8`8)1`8!`8=6`84`8`8-`8 A `8\<`87`8`8&\?6\?\?`8%`8`8%`8`8%`8`8$A`8*`8*`81!`8`8.#`8`8-`8A`8#`83`8 )`86<`82]'3-`8!`82 `8?!`8!`8<#`8 `8;`8)`8A=`8>9]*7`8:_"_"5_ 6_":`8?!]$ `8#]$$`8*_?A_`8_`8 _"" `5-=`0*`80`55`8r3outputcV^8dQhR\R,R\\R,\P!RR.RR73,R\\ R,\P!R R .R R73,R \\R,\P!R RR73,R\\ \,R,\P!RRR73,R\\ R,\P!RRR73,R\\ R,\P!RRR73,R\\\P!RRR73,RR/ #)r.rNr3--formatz-fzXOutput format: fastmcp (FastMCP-specific) or mcp (MCP protocol). Required when using -o.rwr--outputz-ozbOutput file path for the JSON report. If not specified, outputs to stdout when format is provided.r}rrrIryrrrrrr~rrrrrr0)r1rrrKrrrBrJ)r3s"r+r4r4sjjtj d#k   j  t d#u   j"  d  ;   #j0 S D X  1j< t  E  =jJ! t  !A  KjX  e  Yjf gjr5c "V'g\4'dRp\TTT;'g.VVR7wrVPR4'dsVfo\\ V44;_uu_4p \ P !V 4p RRR4RX 9d,\PR4\P!^4R.p XPPT 4T 8g;'dT'*p T 'dRR TR .p T'dT PR TP .4T'dT PR \#T4.4^RIpTPPT 4p\&P(R R/,pTP*!TRTR7p\P!TP,4\P/RRTRTRT'd \#T4MR/R7T'g,\PR4\P!^4TfQhTP0P34GRjxL p\5T4GRjxL pT'dIT'gA\6P9R4\6P9R4\P!^4TEf\6P94\6P9R4\6P9RTP: 24TP<'d#\6P9RTP< 24TP>'d#\6P9RTP> 24TP@'d,\6P9R\CTP@4 24\6P9RTPD 24TPF'd#\6P9RTPF 24\6P94\6P9R4\6P9R \CTPH4 24\6P9R!\CTPJ4 24\6P9R"\CTPL4 24\6P9R#\CTPN4 24\6P94\6P9R$4\6P9R%TPP 24\6P9R&TPR 24\6P94\6P9R'4R#\UTTT4GRjxL pT'dTPVPYRRR(7TPR)4;_uu_4p T P[T4RRR4\P]R*T 24\6P9R+T R,24\6P9R-TP: R.24\6P9R/TP 24R#\6P9TP_R044R# +'giEL;i \ P\3dELi;i \d\P!^4ELi;iELELyEL_ +'giEL;i \`dap\PcR1T 2RTR2\#T4/R7\6P9R3T 24\P!^4Rp?R#Rp?ii;i5i)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)r}ryr~rz.jsonN mcpServersz4MCPConfig files are not supported by inspect commandrrinspectrrrrrrzInspecting serverrr3rrrzG[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])reexist_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: r9u3[bold red]✗[/bold red] Failed to inspect server: )2rrendswithopenrjsonloadr8r9r&r:JSONDecodeErrorrrrrr>r1r(rrr rrrrrrorlrr website_urliconslenserver_generation instructionstoolsprompts resources templatesfastmcp_version mcp_versionrparentmkdirwriterpdecoderr)rr3rr}ryrr~rrfdatarrinspect_commandr(r*rrserverrpformatted_jsonrs&$$$$$$$ r+rrsZ.003 '--2/      ( (V^ ${+,,99Q   " "JF #< =   ..?jj0#66..Dc: ##$ LL ; f Vc&k \ LL5 6 HHQK!!!}}0022%V,, & MMY  MM^  HHQK > MMO MM/ 0 MM,TYYK8 9||| 0?@ 01A1A0BCDzzz 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   sN]Z'ZY=2Y) :Y=']+]; ] $].B%]]([$0A[$>[?[$[  [$[$&B![$3[$<3[$0A[$F [$][$.[ / [$;6[$1[A>[$]$[$']) Y: 4 Y==ZZ]ZZ![][][$ [$ [$ [!  [$$ ]/A] ] ]]zManage FastMCP projectsc (V^8dQhR\\R,\P!RR73,R\\R,\P!RR73,R\\\P!RR73,R R/#) r. config_pathNz'Path to fastmcp.json configuration filerI output_dirz1Directory to create the persistent environment inrz)Skip source preparation (e.g., git clone)r0)rr1rKrrJ)r3s"r+r4r4sTT d  IJ LT  d  ST V T  KL NT Tr5c |"^RIHpVf,\PR4\P !^4Vfm\ P!4pV'd%\V4p\PRV 24M+\PR4\P !^4VfQhV!V4pVP4'g/\PRV 24\P !^4VfQhV!V4p\ P!V4pVPVVR7GRjxL \PRV R V R V R 24R#L% \dRp\PR T 24\PR T 24\P !^4Rp?R#Rp?ii;i5i)aPrepare 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 rNzbThe --output-dir parameter is required. Please specify where to create the persistent environment.zUsing 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: )rru>[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: )pathlibrr8r9r&r:r find_configr1rpexists from_filepreparerorlr) rrrr found_config config_file output_pathrrs &&& r+r"r"sD  I   &224 l+K KK3K=A B LLP  HHQK  "" "{#K      5k]CD   !! !z"K **;7nn#"    L[MZ##.-{:,g O    21#67 LQCPQ  sPAF<A2F< rBs'  %% )%KK5+'T 1?C E  )ll  Q   ,  &,&K  &K &KT ,,E(K L   , -: ;H IV Wd er sB CP Q^ _Ds s !s. /s< =sJ KsR Ss` asl msz {sH IsV Wsd est usB CsP Qs^ _s sl j j !j. /j: ;jH IjV Wjd ej j\ll 0IJ  TTp G K K I Lv & Lv & : . ~ 6 H zEr5