Skip to main content

​
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) -> 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

​
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