fastmcp.cli.run

FastMCP run command implementation with enhanced type hints.

Functions

is_url

is_url(path: str) -> bool

Check if a string is a URL.

create_client_server

create_client_server(url: str) -> Any

Create a FastMCP server from a client URL.Args:

  • url: The URL to connect to

Returns:

  • A FastMCP server instance

create_mcp_config_server

create_mcp_config_server(mcp_config_path: Path) -> FastMCP[None]

Create a FastMCP server from a MCPConfig.

load_mcp_server_config

load_mcp_server_config(config_path: Path) -> MCPServerConfig

Load a FastMCP configuration from a fastmcp.json file.Args:

  • config_path: Path to fastmcp.json file

Returns:

  • MCPServerConfig object

run_command

run_command(server_spec: str, transport: TransportType | None = None, host: str | None = None, port: int | None = None, path: str | None = None, log_level: LogLevelType | None = None, server_args: list[str] | None = None, show_banner: bool = True, use_direct_import: bool = False, skip_source: bool = False, stateless: bool = False) -> None

Run a MCP server or connect to a remote one.Args:

  • server_spec: Python file, object specification (file:obj), config file, or URL
  • transport: Transport protocol to use
  • host: Host to bind to when using http transport
  • port: Port to bind to when using http transport
  • path: Path to bind to when using http transport
  • log_level: Log level
  • server_args: Additional arguments to pass to the server
  • show_banner: Whether to show the server banner
  • use_direct_import: Whether to use direct import instead of subprocess
  • skip_source: Whether to skip source preparation step
  • stateless: Whether to run in stateless mode (no session)

run_module_command

run_module_command(module_name: str) -> None

Run a Python module directly using python -m <module>.When -m is used, the module manages its own server startup. No server-object discovery or transport overrides are applied.Args:

  • module_name: Dotted module name (e.g. my_package).

run_v1_server_async

run_v1_server_async(server: FastMCP1x, host: str | None = None, port: int | None = None, transport: TransportType | None = None) -> None

Run a FastMCP 1.x server using async methods.Args:

  • server: FastMCP 1.x server instance
  • host: Host to bind to
  • port: Port to bind to
  • transport: Transport protocol to use

run_with_reload

run_with_reload(cmd: list[str], reload_dirs: list[Path] | None = None, is_stdio: bool = False) -> None

Run a command with file watching and auto-reload.Args:

  • cmd: Command to run as subprocess (should include —no-reload)
  • reload_dirs: Directories to watch for changes (default: cwd)
  • is_stdio: Whether this is stdio transport

[stdio

Previous](/content/python-sdk/fastmcp-cli-install-stdio/index.html) [tasks

Next](/content/python-sdk/fastmcp-cli-tasks/index.html)

Ctrl+I