# fastmcp.cli.run

FastMCP run command implementation with enhanced type hints.

## Functions

### is_url
```python
is_url(path: str) -> bool
```
Check if a string is a URL.

### create_client_server
```python
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
```python
create_mcp_config_server(mcp_config_path: Path) -> FastMCP[None]
```
Create a FastMCP server from a MCPConfig.

### load_mcp_server_config
```python
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
```python
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
```python
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
```python
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
```python
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