Update CLI docs

docs/deployment/cli.mdx

@@ -0,0 +1,174 @@
+---
+title: FastMCP CLI
+sidebarTitle: CLI
+description: Learn how to use the FastMCP command-line interface
+icon: terminal
+---
+
+import { VersionBadge } from "/snippets/version-badge.mdx"
+
+
+FastMCP provides a command-line interface (CLI) that makes it easy to run, develop, and install your MCP servers. The CLI is automatically installed when you install FastMCP.
+
+```bash
+fastmcp --help
+```
+
+## Commands Overview
+
+| Command | Purpose | Dependency Management |
+| ------- | ------- | --------------------- |
+| `run` | Run a FastMCP server directly | Uses your current environment; you are responsible for ensuring all dependencies are available |
+| `dev` | Run a server with the MCP Inspector for testing | Creates an isolated environment; dependencies must be explicitly specified with `--with` and/or `--with-editable` |
+| `install` | Install a server in the Claude desktop app | Creates an isolated environment; dependencies must be explicitly specified with `--with` and/or `--with-editable` |
+| `version` | Display version information | N/A |
+
+## Command Details
+
+### `run`
+
+Run a FastMCP server directly.
+
+```bash
+fastmcp run server.py
+```
+
+<Tip>
+This command runs the server directly in your current Python environment. You are responsible for ensuring all dependencies are available.
+</Tip>
+
+#### Options
+
+| Option | Flag | Description |
+| ------ | ---- | ----------- |
+| Transport | `--transport`, `-t` | Transport protocol to use (`stdio`, `streamable-http`, or `sse`) |
+| Host | `--host` | Host to bind to when using http transport (default: 127.0.0.1) |
+| Port | `--port`, `-p` | Port to bind to when using http transport (default: 8000) |
+| Log Level | `--log-level`, `-l` | Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL) |
+
+#### Server Specification
+
+The server can be specified in two ways:
+1. `server.py` - imports the module and looks for a FastMCP object named `mcp`, `server`, or `app`. Errors if no such object is found.
+2. `server.py:custom_name` - imports and uses the specified server object
+
+<Tip>
+When using `fastmcp run`, it **ignores** the `if __name__ == "__main__"` block entirely. Instead, it finds your server object and calls its `run()` method directly with the transport options you specify. This means you can use `fastmcp run` to override the transport specified in your code.
+</Tip>
+
+For example, if your code contains:
+
+```python
+# server.py
+from fastmcp import FastMCP
+
+mcp = FastMCP("MyServer")
+
+@mcp.tool()
+def hello(name: str) -> str:
+    return f"Hello, {name}!"
+
+if __name__ == "__main__":
+    # This is ignored when using `fastmcp run`!
+    mcp.run(transport="stdio")
+```
+
+You can run it with Streamable HTTP transport regardless of what's in the `__main__` block:
+
+```bash
+fastmcp run server.py --transport streamable-http --port 8000
+```
+
+**Example**
+
+```bash
+# Run a server with Streamable HTTP transport on a custom port
+fastmcp run server.py --transport streamable-http --port 8000
+```
+
+### `dev`
+
+Run a MCP server with the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) for testing.
+
+```bash
+fastmcp dev server.py
+```
+
+<Tip> 
+This command runs your server in an isolated environment. All dependencies must be explicitly specified using the `--with` and/or `--with-editable` options.
+</Tip>
+
+<Warning>
+The `dev` command is a shortcut for testing a server over STDIO only. When the Inspector launches, you may need to:
+1. Select "STDIO" from the transport dropdown
+2. Connect manually
+
+This command does not support HTTP testing. To test a server over HTTP:
+1. Start your server manually with HTTP transport using either:
+   ```bash
+   fastmcp run server.py --transport streamable-http
+   ```
+   or
+   ```bash
+   python server.py  # Assuming your __main__ block sets HTTP transport
+   ```
+2. Open the MCP Inspector separately and connect to your running server
+</Warning>
+
+#### Options
+
+| Option | Flag | Description |
+| ------ | ---- | ----------- |
+| Editable Package | `--with-editable`, `-e` | Directory containing pyproject.toml to install in editable mode |
+| Additional Packages | `--with` | Additional packages to install (can be used multiple times) |
+| Inspector Version | `--inspector-version` | Version of the MCP Inspector to use |
+| UI Port | `--ui-port` | Port for the MCP Inspector UI |
+| Server Port | `--server-port` | Port for the MCP Inspector Proxy server |
+
+**Example**
+
+```bash
+# Run dev server with editable mode and additional packages
+fastmcp dev server.py -e . --with pandas --with matplotlib
+```
+
+### `install`
+
+Install a MCP server in the Claude desktop app.
+
+```bash
+fastmcp install server.py
+```
+
+<Tip>
+This command installs your server in an isolated environment. All dependencies must be explicitly specified using the `--with` and/or `--with-editable` options.
+</Tip>
+
+<Warning>
+The `install` command currently only sets up servers for STDIO transport. When installed in the Claude desktop app, your server will be run using STDIO regardless of any transport configuration in your code.
+</Warning>
+
+#### Options
+
+| Option | Flag | Description |
+| ------ | ---- | ----------- |
+| Server Name | `--name`, `-n` | Custom name for the server |
+| Editable Package | `--with-editable`, `-e` | Directory containing pyproject.toml to install in editable mode |
+| Additional Packages | `--with` | Additional packages to install (can be used multiple times) |
+| Environment Variables | `--env-var`, `-v` | Environment variables in KEY=VALUE format (can be used multiple times) |
+| Environment File | `--env-file`, `-f` | Load environment variables from a .env file |
+
+**Example**
+
+```bash
+# Install server with custom name, dependencies, and environment variables
+fastmcp install server.py -n "My Analysis Server" -e . --with pandas --env-var API_KEY=12345
+```
+
+### `version`
+
+Display version information about FastMCP and related components.
+
+```bash
+fastmcp version
+```

docs/deployment/running-server.mdx

@@ -11,7 +11,7 @@ FastMCP servers can be run in different ways depending on your application's nee
 
 ## The `run()` Method
 
-The main way to run a FastMCP server from a Python script is by calling the `run()` method on a `FastMCP` instance. 
+FastMCP servers can be run directly from Python by calling the `run()` method on a `FastMCP` instance.
 
 <Tip>
 For maximum compatibility, it's best practice to place the `run()` call within an `if __name__ == "__main__":` block. This ensures the server starts only when the script is executed directly, not when imported as a module.
@@ -33,6 +33,34 @@ You can now run this MCP server by executing `python my_server.py`.
 
 MCP servers can be run with a variety of different transport options, depending on your application's requirements. The `run()` method can take a `transport` argument and other transport-specific keyword arguments to configure how the server operates.
 
+## The FastMCP CLI
+
+FastMCP also provides a command-line interface for running servers without modifying the source code. After installing FastMCP, you can run your server directly from the command line:
+
+```bash
+fastmcp run server.py
+```
+
+<Tip>
+**Important**: When using `fastmcp run`, it **ignores** the `if __name__ == "__main__"` block entirely. Instead, it looks for a FastMCP object named `mcp`, `server`, or `app` and calls its `run()` method directly with the transport options you specify.
+
+This means you can use `fastmcp run` to override the transport specified in your code, which is particularly useful for testing or changing deployment methods without modifying the code.
+</Tip>
+
+You can specify transport options and other configuration:
+
+```bash
+fastmcp run server.py --transport sse --port 9000
+```
+
+For development and testing, you can use the `dev` command to run your server with the MCP Inspector:
+
+```bash
+fastmcp dev server.py
+```
+
+See the [CLI documentation](/deployment/cli) for detailed information about all available commands and options.
+
 ## Transport Options
 
 Below is a comparison of available transport options to help you choose the right one for your needs:

docs/docs.json

@@ -50,8 +50,8 @@
                     "servers/resources",
                     "servers/prompts",
                     "servers/context",
-                    "patterns/proxy",
-                    "patterns/composition"
+                    "servers/proxy",
+                    "servers/composition"
                 ]
             },
             {
@@ -59,7 +59,8 @@
                 "pages": [
                     "deployment/running-server",
                     "deployment/asgi",
-                    "deployment/authentication"
+                    "deployment/authentication",
+                    "deployment/cli"
                 ]
             },
             {
@@ -86,5 +87,15 @@
             }
         ]
     },
+    "redirects": [
+        {
+            "destination": "/servers/proxy",
+            "source": "/patterns/proxy"
+        },
+        {
+            "destination": "/servers/composition",
+            "source": "/patterns/composition"
+        }
+    ],
     "theme": "mint"
 }

src/fastmcp/cli/cli.py

@@ -327,14 +327,14 @@ def run(
         typer.Option(
             "--transport",
             "-t",
-            help="Transport protocol to use (stdio or sse)",
+            help="Transport protocol to use (stdio, streamable-http, or sse)",
         ),
     ] = None,
     host: Annotated[
         str | None,
         typer.Option(
             "--host",
-            help="Host to bind to when using sse transport (default: 127.0.0.1)",
+            help="Host to bind to when using http transport (default: 127.0.0.1)",
         ),
     ] = None,
     port: Annotated[
@@ -342,7 +342,7 @@ def run(
         typer.Option(
             "--port",
             "-p",
-            help="Port to bind to when using sse transport (default: 8000)",
+            help="Port to bind to when using http transport (default: 8000)",
         ),
     ] = None,
     log_level: Annotated[
@@ -350,20 +350,19 @@ def run(
         typer.Option(
             "--log-level",
             "-l",
-            help="Log level for sse transport (DEBUG, INFO, WARNING, ERROR, CRITICAL)",
+            help="Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)",
         ),
     ] = None,
 ) -> None:
     """Run a MCP server.
 
-    The server can be specified in two ways:\n
+    The server can be specified in two ways:
     1. Module approach: server.py - runs the module directly, expecting a server.run() call.\n
     2. Import approach: server.py:app - imports and runs the specified server object.\n\n
 
     Note: This command runs the server directly. You are responsible for ensuring
-    all dependencies are available.\n
-    For dependency management, use `mcp install` or `mcp dev` instead.
-    """  # noqa: E501
+    all dependencies are available.
+    """
     file, server_object = _parse_file_path(file_spec)
 
     logger.debug(