o iq%@sdZddlZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZmZddlZddlZddlmZddlmZddlZddlmZdd lmZdd lmZdd lmZm Z dd l!m"Z"m#Z#m$Z$dd l%m&Z&ddl'm(Z(ddl)m*Z*e&dZ+eZ,ej-ddej.dZ/ddZ0de1de2e1e1ffddZ3e de4e1dBfddZ5e/j6dddee7ej8d d!d"d#ffd$d%Z9e/j6 dxddddddddd&d'e1dBd(ee4e dBej8d)d*d"d#fd+ee4e1dBej8d,d-d"d#fd.ee1dBej8d/d0d1fd2ee:dBej8d3d4d1fd5ee:dBej8d6d7d1fd8ee1dBej8d9d:d1fd;ee dBej8dee dBej8d?d@d1fddfdAdBZ;e/j6 dxdddddddddddddC d'e1dBdDe1dEeejee dBej8d?d@d1fd;ee dBej8dee dBej8d?d@d1fd;ee dBej8ddodIZ>e>j6   dydpee1dBej8dqd1fdree1dBej8dsd1fd\ee7ej8dtd1fddfdudvZ?e/6e>e/6ee@dwkre/dSdS)zz!FastMCP CLI tools using Cyclopts.N)contextmanagerPath) AnnotatedLiteral)Console)Table)run) install_app)FastMCP)is_already_in_uv_subprocessload_and_merge_config) InspectFormat format_infoinspect_fastmcp) get_logger)MCPServerConfig) UVEnvironmentclifastmcpzFFastMCP 2.0 - The fast, Pythonic way to build MCP servers and clients.)namehelpversionc CsNtjdkr%dD]}ztj|dgddd|WStjy"YqwdSdS)z5Get the correct npx command for the current platform.win32)znpx.cmdznpx.exenpxz --versionT)checkcapture_outputNr)sysplatform subprocessr CalledProcessError)cmdr"U/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/fastmcp/cli/cli.py_get_npx_command+s  r$env_varreturncCs<d|vrtdtd|dd\}}||fS)z6Parse environment variable string in format KEY=VALUE.=z6Invalid environment variable format. Must be KEY=VALUE)loggererrorrexitsplitstrip)r%keyvaluer"r"r#_parse_env_var9s   r0argsccsP|dur#tjdd}ztjdg|t_dVW|t_dS|t_wdVdS)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)rargv)r1originalr"r"r# with_argvBs  r4F)copyr5z--copyz%Copy version information to clipboard)rnegativecCstjtjdttttj j dd}t j dd}|j ddd|j d d d|D]\}}||d t|d d q1|rttdddd}| }||Wdn1sawYt|tddSt|dS)z1Display version information and platform details.mcpr()zFastMCP versionz MCP versionzPython versionPlatformzFastMCP root path)rr()paddingboldleft)stylejustifycyanright:  NF)fileforce_terminallegacy_windowsu:[green]✓[/green] Version information copied to clipboard)r __version__ importlibmetadatarrpython_versionr__file__resolveparentsrgrid add_columnitemsadd_rowstrreplacercaptureprint pyperclipr5getconsole)r5infogkv plain_consolerTr"r"r#rYs&    r) with_editable with_packagesinspector_versionui_port server_portpythonwith_requirementsproject server_specr^z--with-editablez\Directory containing pyproject.toml to install in editable mode (can be used multiple times)r_z--withz;Additional packages to install (can be used multiple times)r`z--inspector-versionz#Version of the MCP Inspector to use)rraz --ui-portzPort for the MCP Inspector UIrbz --server-portz'Port for the MCP Inspector Proxy serverrcz--pythonz(Python version to use (e.g., 3.10, 3.11)rdz--with-requirementsz.Requirements file to install dependencies fromrez --projectz2Run the command within the given project directoryc sTz t|||pg|||rdd|Dnd|d\} }|s | jj}Wnty/tdYnwtjd|| jj | jj ||ddz| sNt d td| dusTJ| j IdH} | j rd dl} | jd | jd td d| jj pug} tt| | j } | jst| d| _n| | j_ i}|rt||d<|rt||d<t}|st dtdd}|r|d|7}| jdd|dg}ttj|BddiB}tj||g|d|d}t|jWdStjy}ztj dt|t||jddt|jWYd}~dSd}~wty)tj ddt|idtdYdSw) 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 cSsg|]}t|qSr")rR).0pr"r"r# szdev..N)rcr_rdreeditableportr(zStarting dev server)rfr^r_rarbextraNo configuration availablerzServer 'z' uses deprecated 'dependencies' parameter (deprecated in FastMCP 2.11.4). Please migrate to fastmcp.json configuration file. See https://gofastmcp.com/docs/deployment/server-configuration for details.) stacklevel) dependencies 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-bannerFASTMCP_UV_SPAWNED1TrenvzDev server failed)rDr* 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.rD) r deploymentrkFileNotFoundErrorrr+r)debug environmentrjrqr*source load_serverwarningswarnrDeprecationWarninglistsetrrRr$ build_commanddictosenvironrPrr rzr )rfr^r_r`rarbrcrdreconfigserverrenv_depsall_depsenv_varsnpx_cmd inspector_cmduv_cmdryprocesser"r"r#devsE               r) transporthostrkpath log_level no_bannerrcr_rerd skip_sourceskip_env server_argsr --transportz-tzTransport protocol to use)rrr--hostz>Host to bind to when using http transport (default: 127.0.0.1)rk--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 levelrruzDon'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)c  s| strd} zt|||pg| | |||||| rt| ndd \}}Wnty1tdYnw|p7|jj}|p=|jj}|pC|jj }|pI|jj }|pO|jj }| pU|jj }|rZ|nt jj }tjd|||||||rnt|ngdddg}|j||ko| }|r+d d |g}|r|d |g|d kr|r|d |g|r|dt|g|r|d|g|r|d|g|r|d|d|r|d|||j|}tjddiB}tdd|ztj|d|d}t|jWdStjy*}ztjd||t||jddt|jWYd}~dSd}~wwztj |||||||r;t|ng| | d IdHWdSt!yo}ztjd||t|ddtdWYd}~dSd}~ww)aaRun 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 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 TN) rcr_rdrerrrkrrrr(zRunning server or client)rfrrrkrrrrltestrr rstdiorrrrrurz--rvrwzRunning command: rCrxzFailed to run: )rfr*rz) rfrrrkrrr show_bannerrrfr*)"r r rr|rr+r{rrrkrrr1rsettingsshow_cli_bannerr)r}r~rextendrRappendrrjoinrr rzr exception run_module run_command Exception)rfrrrkrrrrcr_rerdrrrrfinal_transport final_host final_port final_pathfinal_log_levelfinal_server_argsfinal_no_bannertest_cmdneeds_uv inner_cmdr!ryrrr"r"r#r 1s o               r )formatoutputrcr_rerdrr--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.c sv|strd}zPt|||pg||d\}}|drW|durWz+tt| } t| } Wdn1s6wYd| vrItdt dWn tj t fyVYnwWnt yft dYnwdg} |j | | kot| } | rd d |d g} |r| d |jg|r| d t|gddl}|j | }tjddiB}|j|d|d}t |jtjd|||rt|ndddzG|stdt d|dusJ|jIdH}t|IdH}|r|stdtdt d|durttdtd|j|jrtd|j|jr)td|j|j r8tdt!|j td|j"|j#rNtd|j#ttdtd t!|j$td!t!|j%td"t!|j&td#t!|j'ttd$td%|j(td&|j)ttd'WdSt*|||IdH}|r|j+j,ddd(|d) } | -|Wdn 1swYt.d*|td+|d,td-|jd.td/|jWdSt|/d0WdSt0y:}z#tj1d1||t|d2dtd3|t dWYd}~dSd}~ww)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)rcr_rdrez.jsonN mcpServersz4MCPConfig files are not supported by inspect commandr(rrinspectrrrrrvrwrxzInspecting server)rfrrrlrnzG[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])rMexist_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: )2r r endswithopenrjsonloadr)r*rr+JSONDecodeErrorr|r~rrr/rRrrrr rzr}rrrrXrUrr website_urliconslenserver_generation instructionstoolsprompts resources templatesfastmcp_version mcp_versionrparentmkdirwriterYdecoderr)rfrrrcr_rerdrrfdatarrinspect_commandrr!ryrrrYformatted_jsonrr"r"r#rs P                    rzManage 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 s2ddlm}|durtdtd|dur6t}|r,t|}t d|n tdtd||}| sKtd|td||}z!t |}|j ||d IdHt d |d |d |d WdSty}ztd|t d|tdWYd}~dSd}~ww)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.r(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: )pathlibrr)r*rr+r find_configrRrYexists from_filepreparerXrUr) rrrr found_config config_file output_pathrrr"r"r#rsP "      r__main__)N)NNF)A__doc__importlib.metadatarHimportlib.utilrrrrr contextlibrrrtypingrrcycloptsrV rich.consoler rich.tablerr fastmcp.clir rfastmcp.cli.installr fastmcp.server.serverr fastmcp.utilities.clir r fastmcp.utilities.inspectrrrfastmcp.utilities.loggingr#fastmcp.utilities.mcp_server_configr6fastmcp.utilities.mcp_server_config.v1.environments.uvrr)rXApprGappr$rRtupler0rr4commandbool Parameterrintr TransportTyper project_appr__name__r"r"r"r#s             %   !(/6= 2   &.5 =DKS[ j    '.6 r     V