generate

fastmcp.cli.generate

Generate a standalone CLI script from an MCP server’s capabilities.

Functions

serialize_transport

serialize_transport(resolved: str | dict[str, Any] | ClientTransport) -> tuple[str, set[str]]

Serialize 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.

generate_cli_script

generate_cli_script(server_name: str, server_spec: str, transport_code: str, extra_imports: set[str], tools: list[mcp.types.Tool]) -> str

Generate the full CLI script source code.

generate_cli_command

generate_cli_command(server_spec: Annotated[str, cyclopts.Parameter(help='Server URL, Python file, MCPConfig JSON, discovered name, or .js file')], output: Annotated[str, cyclopts.Parameter(help='Output file path (default: cli.py)')] = 'cli.py') -> None

Generate 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.

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