+ Q(iraR4t/0tRt^RIt^RIt^RIt^RIt^RIHt^RIH t H t ^RI H t ^RI t ^RIt^RIt^RIHt^RIHt^RIHtHt^RIHt^R IHt^R IHt]!R 4t]!4t0R5mtRRlt RRlt!RRlt"RRlt#RRlt$RRlt%RRlt&RR lt'R R R R RRRRRRR!R!R"R"/t(]^kR#R$lt)R%R&lt*R'R(lt+R)R*lt,R6R+R,R-RR.RR/R,/R0R1lllt-R2R3lt.R#)7zDGenerate a standalone CLI script and agent skill from an MCP server.N)Path) AnnotatedAny)urlparse)McpError)Console) _build_clientresolve_server_spec)ClientTransport)StdioTransport) get_loggerz cli.generatestringintegernumberbooleannullcRV^8dQhR\\\3,R\/#schemareturn)dictstrrbool)formats"Z/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/fastmcp/cli/generate.py __annotate__r s"((DcN(t(cVPR4p\V\4'd5\;QJdRV4F 'dK R# R#!RV44#V\9#)z9Check if a schema represents a simple (non-complex) type.typec32"TF q\9xK R#5iN) _SIMPLE_TYPES).0ts& r "_is_simple_type..%s;{! %{sFT)get isinstancelistallr")r schema_types& r_is_simple_typer, sQ**V$K+t$$s;{;ss;s;s;{;;; - ''rcV^8dQhR\\\3,R\\\R,3,/#)rrrNrrrtupler)rs"rrr)s0T#s(^dC$J6F0GrcVPR4R8wdR #VPR/4p\V4'gR #VPRR4p\V\4'dR #RRRRRR R R /pVPV4pVfR #R V3#)zXCheck if schema is an array of simple types. Returns (is_simple_array, item_type_str). rarrayitemsr rrintrfloatrrT)FN)r'r,r(r))rr2 item_typetype_mappy_types& r_is_simple_arrayr8)s zz&W$ JJw #E 5 ! ! &(+I)T""%5'6 H ll9%G =rctV^8dQhR\\\3,R\\\3,/#rr.)rs"rrrEs+##4S>#eCI6F#rc z\V4wrV'd RV R2R3#\V4'dVPRR4p\V\4'd@RRRRR R R R R R/pVUu.uFqTPVR4NK ppRP V4R3#RRRRR R R R R R/pVPVR4R3#R#uupi)zcConvert a JSON Schema to a Python type annotation. Returns (type_annotation, needs_json_parsing). list[]Frr rrr3rr4rrrNone | )rT)r8r,r'r(r)join)r is_simple_arrr5r+r6r$partss& r_schema_to_python_typerBEs 07Myk#U**vjj2 k4 ( (%5'6 H6AA[\\!U+[EA::e$e+ + e u g v F  ||K/66 Bs'B8cRV^8dQhR\\\3,R\/#rrrr)rs"rrrks"&&DcN&s&rc\P!V^R7P4pVPR4pRP V4pRV 2#)z.Format a JSON schema for display in help text.)indent z z JSON Schema: ) pydantic_coreto_jsondecodesplitr?)r schema_strlinesindenteds& r_format_schema_for_helprOksL&&va8??AJ   T "E-2259H 8* %%rcV^8dQhR\\\\3,,\,R\\\ \,3,/#)rresolvedr)rrrr r/set)rs"rrrzs;!!DcN"_4! 3C=!rc>\V\4'd\V4\43#\V\4'dRVP : 2RVP : 2.pVP'd VPRVP: 24VP'd VPRVP: 24RRPV4 R2pR0pW#3#\V\4'd\V4\43#\V4\43#) zSerialize a resolved transport to a Python expression string. Returns ``(expression, extra_imports)`` where *extra_imports* is a set of import lines needed by the expression. zcommand=zargs=zenv=zcwd=zStdioTransport(, )z4from fastmcp.client.transports import StdioTransport) r(rreprrRr commandargsenvappendcwdr?r)rQrAexprimportss& rserialize_transportr^zs(C  H~su$$(N++H,,/0E(--9J2KL <<< LL4 /0 1 <<< LL4 /0 1 5!1 2!4IJ}(D!!H~su$$ >35  rc0V^8dQhR\R\/#)rnamerr)rs"rrrsrc\P!RRV4pV'd#V^,P4'dRV 2pT;'gRp\P!V4'dV R2pV#)z1Sanitize a string into a valid Python identifier.z [^a-zA-Z0-9_]__unnamed)resubisdigitkeyword iskeyword)r`safes& r_to_python_identifierrksa 66"C .D Q!!4&z   :Dqz KrcXV^8dQhR\PPR\/#)rtoolrmcptypesToolr)rs"rrrs&mm m3mrc aVPpVPR/4p\VPR.44p.p.p.p/pVP4EFwop\ V4wrVPRR4p SV9p \ S4p W9d\ RS RW}, RV R24hSW}&V 'd0\V4pV 'dV R V 2MTp VPSV 34V PR R 4PR R 4PRR 4pV 'd#RV RV R2pVPRV RV R24MVPR4pVeV 'dQ\P!V\R7P4pRV RV R2pVPRV RV RV: R24MRV RV R2pVPRV RV RV: R24MZV PR4'd#RV RV R2pVPRV RV R24M!RV RV R2pVPRV RV R24VPS: RV 24EK \ VP4pVP ;'gRPR R 4PRR4p.pVPR4VPRVP: R24VPRV R 24V'd#VPR!4VP#V4VPR"4VPR#V R$24V'dLVPR%4VF#wpp VPRV R&V R'V R(V 24K% VPR4.pVP4Fwop\ S4p \$;QJdV3R)lV4F 'gK R*M R+M!V3R)lV44'dVPS: RV R,24KkVPS: RV 24K R-P'V4pVPR.VP: R/V R024VPR4RP'V4#)1zEGenerate the source for a single ``@call_tool_app.command`` function. propertiesrequired descriptionzParameter name collision: 'z' and 'z' both sanitize to ''z\n\\\"\"rGz Annotated[z, cyclopts.Parameter(help="z")]z z: ,default)fallbackz = r;z = [],z" | None, cyclopts.Parameter(help="z = None,z\'z@call_tool_app.command(name=rUz async def (z *,z ) -> None:z '''z'''z # Parse JSON parametersz_parsed = json.loads(z) if isinstance(z , str) else c32<"TF wrVS8HxK R#5ir!)r#pnrc prop_names& rr%(_tool_function_source.. s8K52rYKsTF_parsedrTz await _call_tool(z, {z})) inputSchemar'rRr2rBrk ValueErrorrOrZreplacerHrIrrJ startswithr`ruextendanyr?)rmrrsrt param_lines call_args json_params seen_names prop_schemar7 needs_json help_text is_required safe_name schema_help help_escaped annotationr} default_strfn_namerurM _prop_namecall_arg_partsrc dict_itemsrs& @r_tool_function_sourcers   F!'L"!=J6::j"-.H KI)+K!#J","2"2"4 ;4[AOOM26 8+ ))4   "-i[ @U?VW%%.Kq2 !*  1+>K:C9+S 6I    95 6   dF + 3 3C ? G Ge T  WI%@cR    i[:,a@ A!ooi0G""/"7"7#"N"U"U"WK#-gY6QR^Q__b!cJ&&ykJ? LL:gYa() X [! LL LL7;-s+, 23%0 !J LLyk!6ykAQR[Q\\hirhst &1  RN"((* 1))4 38K83338K8 8 8  ! !YMI;g"F G  ! !YMI;"? @ +>*J LL( T*SIJ LL 99U rc V^8dQhR\R\R\R\\,R\\PP ,R\/#)r server_name server_spectransport_code extra_importstoolsr)rrRr)rorprq)rs"rrrs]kkkkks8 k    k  krc(VPRR4P4PRR4PRR4p.pVPR4VPRV R 24VPR 4VPR V 24VPR 4VPR 4VPR 4VPR4VPR4VPR 4VPR4VPR4VPR4VPR 4VPR4\V4FpVPV4K VPR 4VPR4VPRV 24VPR 4VPRR4PRR4pVPRV RV R24VPR4VPR4VPR 4VPR4VPR 4VPR 4VP\P !R44VPR 4VPR 4VP\P !R44VPR 4VPR 4V'dWVPR4VPR4VPR4VFp VP\ V 44K VPR 4VPR 4VPR!4VPR 4R"PV4#)#z)Generate the full CLI script source code. -rxryrzr{z#!/usr/bin/env python3z """CLI for z MCP server.rvz#Generated by: fastmcp generate-cli z"""z import jsonz import syszfrom typing import Annotatedzimport cycloptszimport mcp.typesz from rich.console import Consolezfrom fastmcp import Clientz?# Modify this to change how the CLI connects to the MCP server.zCLIENT_SPEC = zapp = cyclopts.App(name="z", help="CLI for z MCP server")zPcall_tool_app = cyclopts.App(name="call-tool", help="Call a tool on the server")zapp.command(call_tool_app)zconsole = Console()ao # --------------------------------------------------------------------------- # Helpers # --------------------------------------------------------------------------- def _print_tool_result(result): if result.is_error: for block in result.content: if isinstance(block, mcp.types.TextContent): console.print(f"[bold red]Error:[/bold red] {block.text}") else: console.print(f"[bold red]Error:[/bold red] {block}") sys.exit(1) if result.structured_content is not None: console.print_json(json.dumps(result.structured_content)) return for block in result.content: if isinstance(block, mcp.types.TextContent): console.print(block.text) elif isinstance(block, mcp.types.ImageContent): size = len(block.data) * 3 // 4 console.print(f"[dim][Image: {block.mimeType}, ~{size} bytes][/dim]") elif isinstance(block, mcp.types.AudioContent): size = len(block.data) * 3 // 4 console.print(f"[dim][Audio: {block.mimeType}, ~{size} bytes][/dim]") async def _call_tool(tool_name: str, arguments: dict) -> None: # Filter out None values and empty lists (defaults for optional array params) filtered = { k: v for k, v in arguments.items() if v is not None and (not isinstance(v, list) or len(v) > 0) } async with Client(CLIENT_SPEC) as client: result = await client.call_tool(tool_name, filtered, raise_on_error=False) _print_tool_result(result) if result.is_error: sys.exit(1)u # --------------------------------------------------------------------------- # List / read commands # --------------------------------------------------------------------------- @app.command async def list_tools() -> None: """List available tools.""" async with Client(CLIENT_SPEC) as client: tools = await client.list_tools() if not tools: console.print("[dim]No tools found.[/dim]") return for tool in tools: sig_parts = [] props = tool.inputSchema.get("properties", {}) required = set(tool.inputSchema.get("required", [])) for pname, pschema in props.items(): ptype = pschema.get("type", "string") if pname in required: sig_parts.append(f"{pname}: {ptype}") else: sig_parts.append(f"{pname}: {ptype} = ...") sig = f"{tool.name}({', '.join(sig_parts)})" console.print(f" [cyan]{sig}[/cyan]") if tool.description: console.print(f" {tool.description}") console.print() @app.command async def list_resources() -> None: """List available resources.""" async with Client(CLIENT_SPEC) as client: resources = await client.list_resources() if not resources: console.print("[dim]No resources found.[/dim]") return for r in resources: console.print(f" [cyan]{r.uri}[/cyan]") desc_parts = [r.name or "", r.description or ""] desc = " — ".join(p for p in desc_parts if p) if desc: console.print(f" {desc}") console.print() @app.command async def read_resource(uri: Annotated[str, cyclopts.Parameter(help="Resource URI")]) -> None: """Read a resource by URI.""" async with Client(CLIENT_SPEC) as client: contents = await client.read_resource(uri) for block in contents: if isinstance(block, mcp.types.TextResourceContents): console.print(block.text) elif isinstance(block, mcp.types.BlobResourceContents): size = len(block.blob) * 3 // 4 console.print(f"[dim][Blob: {block.mimeType}, ~{size} bytes][/dim]") @app.command async def list_prompts() -> None: """List available prompts.""" async with Client(CLIENT_SPEC) as client: prompts = await client.list_prompts() if not prompts: console.print("[dim]No prompts found.[/dim]") return for p in prompts: args_str = "" if p.arguments: parts = [a.name for a in p.arguments] args_str = f"({', '.join(parts)})" console.print(f" [cyan]{p.name}{args_str}[/cyan]") if p.description: console.print(f" {p.description}") console.print() @app.command async def get_prompt( name: Annotated[str, cyclopts.Parameter(help="Prompt name")], *arguments: str, ) -> None: """Get a prompt by name. Pass arguments as key=value pairs.""" parsed: dict[str, str] = {} for arg in arguments: if "=" not in arg: console.print(f"[bold red]Error:[/bold red] Invalid argument {arg!r} — expected key=value") sys.exit(1) key, value = arg.split("=", 1) parsed[key] = value async with Client(CLIENT_SPEC) as client: result = await client.get_prompt(name, parsed or None) for msg in result.messages: console.print(f"[bold]{msg.role}:[/bold]") if isinstance(msg.content, mcp.types.TextContent): console.print(f" {msg.content.text}") elif isinstance(msg.content, mcp.types.ImageContent): size = len(msg.content.data) * 3 // 4 console.print(f" [dim][Image: {msg.content.mimeType}, ~{size} bytes][/dim]") else: console.print(f" {msg.content}") console.print()zM# ---------------------------------------------------------------------------z.# Tool commands (generated from server schema)zif __name__ == "__main__":z app()rG)rlowerrZsortedtextwrapdedentrr?) rrrrrapp_namerMimpserver_name_escapedrms &&&&& rgenerate_cli_scriptrs C%++-55dFCKKCQVW E LL)* LL;{m<89 LL LL6{mDE LL LL LL LL LL/0 LL LL"# LL#$ LL34 LL LL-.m$ S% LL LLRS LL>.!123 LL&--dF;CCCO LL #H:->?R>SS`a LLZ LL-. LL LL&' LL LL LL)#) $+X LL LL LLi'i (kX LL LL  [   EF [ D LL.t4 5 LL LL-. LL LL 99U rr1objectc0V^8dQhR\R\/#)rrrra)rs"rrrs , ,# ,# ,rc\V4p\P!RRV4p\P!RRV4pVP4P RR4P R4pV'dRV 2#R#)uConvert a JSON Schema property name to its CLI flag form. Replicates cyclopts' default_name_transform: camelCase → snake_case, lowercase, underscores → hyphens, strip leading/trailing hyphens. z(.)([A-Z][a-z]+)z\1_\2z([a-z0-9])([A-Z])rcrz--z--arg)rkrerfrrstrip)rrjs& r_param_to_cli_flagrsj ! +D 66%x 6D 66&$ 7D ::<  S ) / / 4DRv;+G+rcRV^8dQhR\\\3,R\/#)rrrrD)rs"rrr&s"DcNsrcVPRR4p\V\4'd6VUu.uFp\PW"4NK ppRP V4#\PW4pVR8XdLVPR/4pVPRR4p\V\ 4'dV\9dRV R2#V#uupi) z9Return a human-readable type label for a property schema.rr r>r1r2rvzarray[r<)r'r(r)_JSON_SCHEMA_TYPE_LABELSr?r)rr+r$labelslabelr2r5s& r_schema_type_labelr&s//&(3K+t$$>IJk*..q4kJzz&!! $ ( ( BEg,IIfb) i % %)7O*OI;a( ( LKsCcdV^8dQhR\PPR\R\/#)rrm cli_filenamerrn)rs"rrr9s)11ciinn1C1C1rc  VPpVPR/4p\VPR.44p.pVP4Fzwrg\ V4pVPR4p V R8H;'g\ V \ 4;'dRV 9p V 'dVPV4KfVPV R24K| RPV4p RV RVP 2p V 'd V RV 2, p .p VP4FwrR \ V4 R 2p\V4PR R 4pW9dR MR pVPRR4p\V4wppV'dV'dV R2MRpVPRR4PR R 4pV PRV RV RV RV R2 4K RpV 'd&RpRV R2RPV 4,R,pRVP 2.pVP'dVPRVP.4VPRRV R.4V'd#VPRVPR4.4RPV4#)z.Generate a SKILL.md section for a single tool.rsrtrrz ruv run --with fastmcp python z call-tool `|z\|yesnorurvz (JSON string)z JSON stringrGz| r>z |zQ| Flag | Type | Required | Description | |------|------|----------|-------------|z### ```bash```)rr'rRr2rr(r)rZr?r`rrrBrurr)rmrrrsrtflag_parts_listpp_schemaflagr+is_bool flag_parts invocationrowsrr type_labelrrurcr param_tableheaderrMs&& r_tool_skill_sectionr9sn   F!'L"!=J6::j"-.H"$O!'') !!$ll6* *  {D ) F Fi;.F    " "4 (  " "dV8#4 5*/*J0k$))UJ*&& D","2"2"4 %i013' 4< tyyk*+E  b$**+, LL"iU34 b+++D123 99U rcV^8dQhR\R\R\\PP,R\/#)rrrrr)rr)rorprq)rs"rrrms=++++   + +rc aVPRR4P4PRR4PRR4pVPRR4PRR4pRV R2pRR V R 2R V R2RRR V R 2R.pV'd1RPV3RlV44pVPRRVR.4VPRRRRS R2RS R2RS R2RS R2RS R2RR. 4RPV4#)z4Generate a SKILL.md file for a generated CLI script.rrrxrvrzz CLI for the z9 MCP server. Call tools, list resources, and get prompts.z---zname: "z-cli"zdescription: "z# z CLIz c3<<"TFp\VS4xK R#5ir!)r)r#rmrs& rr%)generate_skill_content..s" @E l 3 3sz## Tool Commandsz## Utility Commandsrrz list-toolsz list-resourcesz read-resource z list-promptsz" get-prompt [key=value ...]rrG)rrr?r)rrr skill_namerrurM tool_bodiess&f& rgenerate_skill_contentrmsM C%++-55dB?GGRP##D"-55c2>I  +deK  *U#  Q'  [M  E kk" @E"    ("k2>? LL !  +L> E+L> I+L>9M N+L> G+L>9[ \     99U rforceFtimeoutauthno_skillc$V^8dQhR\\\P!RR73,R\\\P!RR73,R\\\P!RR.R R 73,R \\ R ,\P!R RR73,R\\R ,\P!RRR73,R\\\P!RRR73,RR /#)rrzEServer URL, Python file, MCPConfig JSON, discovered name, or .js file)helpoutputz"Output file path (default: cli.py)rz-fz--forcez"Overwrite output file if it exists)r`rrNz --timeoutzConnection timeout in secondsrz--authzAAuth method: 'oauth', a bearer token string, or 'none' to disablerz --no-skillz8Skip generating a SKILL.md agent skill alongside the CLIr)rrcyclopts Parameterrr4)rs"rrrs1uBuB X  uB  5   uB   "5   uB*  ;-LM O+uB2  d  T   3uB@  K  AuBN OuBrc "\V4pVPR, p.pVP4'dV'gVPV4V'g0VP4'dV'gVPV4V'dHRP RV44p \ P RV R24\P!^4\V4p \V 4wr\V4p \WVR7pT;_uu_4GRjxL VP4GRjxL p\ P R\V4 R V R 24RRR4GRjxL \'T TT T XR 7pTP)T4TP+TP-4P.^I,4\ P R T R\T4 R24T'gC\1T TP2TR7pTP)T4\ P R T R24\ P RT R24R#EL-ELL +GRjxL 'giL;i \\ \"\$3d:p\ P R T 24\P!^4Rp?ELNRp?ii;i5i)aGenerate a standalone CLI script from an MCP server. Connects to the server, reads its tools/resources/prompts, and writes a Python script that can invoke them directly. Also generates a SKILL.md agent skill file unless --no-skill is passed. Examples: fastmcp generate-cli weather fastmcp generate-cli weather my_cli.py fastmcp generate-cli http://localhost:8000/mcp fastmcp generate-cli server.py output.py -f fastmcp generate-cli weather --no-skill zSKILL.mdrTc3."TF pRV R2xK R#5i)z[cyan][/cyan]Nr)r#rs& rr%'generate_cli_command..s@x!F1#W-xsz[bold red]Error:[/bold red] z4 already exist(s). Use [cyan]-f[/cyan] to overwrite.)rrNz[dim]Discovered z tool(s) from z[/dim]z/[bold red]Error:[/bold red] Could not connect: )rrrrru[green]✓[/green] Wrote [cyan]z [/cyan] with z tool command(s))rrrrz[dim]Run: python z --help[/dim])rparentexistsrZr?consoleprintsysexitr r^_derive_server_namer list_toolslen RuntimeError TimeoutErrorrOSErrorr write_textchmodstatst_moderr`)rrrrrr output_path skill_pathexistingnamesrQrrrclientrexcscript skill_contents&&$$$$ rgenerate_cli_commandrs=jv,K##j0JHE $  ))++E # @x@@ *5'20 1   #;/H$7$A!N&k2K84 @F 66 ++--E MM"3u:,n[MP 6!%# F6"k&&(00589 MM )+7E |+ - .#$)) m, 7 |7KL MM%k]-@AI-666 ,' : GuMN  s>J?J?J?0J?8J?A7J? I(II(I /I0)I  I($I %I()CJ?I(I  I( I% I I% I% I($J?%I((J<.J71J?7J<<J?c0V^8dQhR\R\/#)rrrra)rs"rrrsSSrcTVPR4'd"\V4pVP;'gR#VPR4'd\ V4P #RV9d=VP R^4^,pT;'gVP R^4^,#V#)z0Derive a human-friendly name from a server spec.server:)zhttp://zhttps://)z.pyz.jsz.json)rrhostnameendswithrstemrK)rparsedr`s& rrrs566+&**(*344K %%% k  a(+33{((a033 rcbV^8dQh/^\9d\\\3,;R&#)rr)__conditional_annotations__rr)rs"rrrs)JJX$sCx.YKr>rrr rr)zcli.py)0r__doc__rhrerrpathlibrtypingrr urllib.parserr mcp.typesrorHr rich.consolerfastmcp.cli.clientrr fastmcp.client.transports.baser fastmcp.client.transports.stdior fastmcp.utilities.loggingr loggerrr"r,r8rBrOr^rkrrrrrrrrrr)rs@rrsJ !! A::0 N # ) C (8#L&!Bmjkf h y h y F W h, ,&1h+fuB( )uB0 1uB> ?uBL MuBuBpr