From 8a4466fab1e55e8ef05db969f7345367e5943be6 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Thu, 29 Jan 2026 14:30:45 +0000 Subject: [PATCH] docs: document expanded reload file watching Add documentation for PR #3028 which expanded --reload to watch common frontend file types (JavaScript, TypeScript, CSS, HTML, etc.) in addition to Python files. - Add 3.0.0beta2 section to v3-features.mdx - Update CLI Auto-Reload section with reference to file type expansion - Update running-server.mdx to mention variety of watched file types Co-authored-by: Jeremiah Lowin --- docs/deployment/running-server.mdx | 2 +- docs/development/v3-notes/v3-features.mdx | 11 ++++++++++- 2 files changed, 11 insertions(+), 2 deletions(-) diff --git a/docs/deployment/running-server.mdx b/docs/deployment/running-server.mdx index bf4b83161..d28f9c2e8 100644 --- a/docs/deployment/running-server.mdx +++ b/docs/deployment/running-server.mdx @@ -169,7 +169,7 @@ During development, you can use the `--reload` flag to automatically restart you fastmcp run server.py --reload ``` -The server watches for changes to Python files in the current directory and restarts automatically when you save changes. This provides a fast feedback loop during development without manually stopping and starting the server. +The server watches for changes to Python, JavaScript, TypeScript, CSS, HTML, and other common source files in the current directory. It restarts automatically when you save changes, providing a fast feedback loop during development without manually stopping and starting the server. ```bash # Watch specific directories for changes diff --git a/docs/development/v3-notes/v3-features.mdx b/docs/development/v3-notes/v3-features.mdx index 5bd8676a3..538832807 100644 --- a/docs/development/v3-notes/v3-features.mdx +++ b/docs/development/v3-notes/v3-features.mdx @@ -4,6 +4,14 @@ title: v3.0 Feature Tracking This document tracks major features in FastMCP v3.0 for release notes preparation. +## 3.0.0beta2 + +### Expanded Reload File Watching + +The `--reload` flag now watches common frontend file types (JavaScript, TypeScript, CSS, HTML, and more) in addition to Python files ([#3028](https://github.com/jlowin/fastmcp/pull/3028)). This enables seamless development for MCP apps that include frontend bundles, automatically restarting the server when any relevant source files change. + +--- + ## Provider-Based Architecture v3.0 introduces a provider-based component system that replaces v2's static-only registration ([#2622](https://github.com/jlowin/fastmcp/pull/2622)). Providers dynamically source tools, resources, templates, and prompts at runtime. @@ -554,7 +562,7 @@ Environment variable: `FASTMCP_DECORATOR_MODE=object` ## CLI Auto-Reload -The `--reload` flag enables file watching with automatic server restarts for development ([#2816](https://github.com/jlowin/fastmcp/pull/2816)). +The `--reload` flag enables file watching with automatic server restarts for development ([#2816](https://github.com/jlowin/fastmcp/pull/2816)). The server watches common source file types including Python, JavaScript, TypeScript, CSS, HTML, and configuration files ([#3028](https://github.com/jlowin/fastmcp/pull/3028)). ```bash # Watch for changes and restart @@ -569,6 +577,7 @@ fastmcp run server.py --reload --transport http --port 8080 Implementation (`src/fastmcp/cli/run.py`): - Uses `watchfiles` for efficient file monitoring +- Watches Python, JavaScript, TypeScript, CSS, HTML, and other common source files - Runs server as subprocess for clean restarts - Stateless mode for seamless reconnection after restart - stdio: Full MCP features including elicitation