feat: Add real-time monitoring and auto-refresh capabilities to file watcher documentation

Author: johnhuang316

README.md

@@ -41,6 +41,12 @@ Code Index MCP is a [Model Context Protocol](https://modelcontextprotocol.io) se
 - **Others**: Lua, Perl, R, MATLAB, configuration files
 - **50+ File Types Total** - [View complete list](#supported-file-types)
 
+### ⚡ **Real-time Monitoring & Auto-refresh**
+- **File Watcher**: Automatic index updates when files change
+- **Cross-platform**: Native OS file system monitoring (inotify, FSEvents, ReadDirectoryChangesW)
+- **Smart Debouncing**: Batches rapid changes to prevent excessive rebuilds (default: 6 seconds)
+- **Thread-safe**: Non-blocking background operations with ThreadPoolExecutor
+
 ### ⚡ **Performance & Efficiency**
 - **Smart Indexing**: Recursively scans with intelligent filtering of build directories
 - **Persistent Caching**: Stores indexes for lightning-fast subsequent access
@@ -128,7 +134,7 @@ Code Index MCP is a [Model Context Protocol](https://modelcontextprotocol.io) se
 
 The easiest way to get started with any MCP-compatible application:
 
-**Prerequisites:** Python 3.10+ and [uv](https://github.com/astral-sh/uv) installed
+**Prerequisites:** Python 3.10+, [uv](https://github.com/astral-sh/uv), and [watchdog](https://pypi.org/project/watchdog/) for file monitoring
 
 1. **Add to your MCP configuration** (e.g., `claude_desktop_config.json` or `~/.claude.json`):
    ```json
@@ -211,6 +217,12 @@ Then configure:
 | **`find_files`** | Locate files using glob patterns (e.g., `**/*.py`) |
 | **`get_file_summary`** | Analyze file structure, functions, imports, and complexity |
 
+### 🔄 **Monitoring & Auto-refresh**
+| Tool | Description |
+|------|-------------|
+| **`get_file_watcher_status`** | Check file watcher status and configuration |
+| **`configure_file_watcher`** | Enable/disable auto-refresh and configure settings |
+
 ### 🛠️ **System & Maintenance**
 | Tool | Description |
 |------|-------------|
@@ -273,6 +285,16 @@ Search for "API_ENDPOINT" only in Python files
 
 </details>
 
+<details>
+<summary><strong>Auto-refresh Configuration</strong></summary>
+
+```
+Configure automatic index updates when files change
+```
+*Uses: `configure_file_watcher` to enable/disable monitoring and set debounce timing*
+
+</details>
+
 <details>
 <summary><strong>Project Maintenance</strong></summary>
 

README_ja.md

@@ -41,6 +41,12 @@ Code Index MCPは、AIモデルと複雑なコードベースの橋渡しをす
 - **その他の言語**：Lua、Perl、R、MATLAB、設定ファイル
 - **合計50+ファイルタイプ** - [完全なリストを表示](#サポートされているファイルタイプ)
 
+### ⚡ **リアルタイム監視・自動更新**
+- **ファイルウォッチャー**：ファイル変更時の自動インデックス更新
+- **クロスプラットフォーム**：ネイティブOS ファイルシステム監視 (inotify、FSEvents、ReadDirectoryChangesW)
+- **スマートデバウンス**：急速な変更をバッチ処理して過度な再構築を防止（デフォルト：6秒）
+- **スレッドセーフ**：ThreadPoolExecutor による非ブロッキングバックグラウンド操作
+
 ### ⚡ **パフォーマンス・効率性**
 - **スマートインデックス作成**：ビルドディレクトリをインテリジェントにフィルタリングしながら再帰的スキャン
 - **永続キャッシュ**：超高速な後続アクセスのためのインデックス保存
@@ -128,7 +134,7 @@ Code Index MCPは、AIモデルと複雑なコードベースの橋渡しをす
 
 任意のMCP対応アプリケーションで開始する最も簡単な方法：
 
-**前提条件：** Python 3.10+ と [uv](https://github.com/astral-sh/uv) がインストール済み
+**前提条件：** Python 3.10+、[uv](https://github.com/astral-sh/uv)、ファイル監視用の [watchdog](https://pypi.org/project/watchdog/) がインストール済み
 
 1. **MCP設定に追加**（例：`claude_desktop_config.json` または `~/.claude.json`）：
    ```json
@@ -211,6 +217,12 @@ pip install code-index-mcp
 | **`find_files`** | globパターンを使用したファイル検索（例：`**/*.py`） |
 | **`get_file_summary`** | ファイル構造、関数、インポート、複雑度の解析 |
 
+### 🔄 **監視・自動更新**
+| ツール | 説明 |
+|--------|------|
+| **`get_file_watcher_status`** | ファイルウォッチャーの状態と設定を確認 |
+| **`configure_file_watcher`** | 自動更新の有効化/無効化と設定の構成 |
+
 ### 🛠️ **システム・メンテナンス**
 | ツール | 説明 |
 |--------|------|
@@ -273,6 +285,16 @@ Pythonファイルのみで "API_ENDPOINT" を検索してください
 
 </details>
 
+<details>
+<summary><strong>自動更新設定</strong></summary>
+
+```
+ファイル変更時の自動インデックス更新を設定してください
+```
+*使用ツール：`configure_file_watcher` で監視の有効化/無効化とデバウンス時間を設定*
+
+</details>
+
 <details>
 <summary><strong>プロジェクトメンテナンス</strong></summary>
 

README_zh.md

@@ -41,6 +41,12 @@
 - **其他語言**：Lua、Perl、R、MATLAB、配置檔案
 - **共 50+ 種檔案類型** - [查看完整列表](#支援的檔案類型)
 
+### ⚡ **即時監控與自動刷新**
+- **檔案監控器**：檔案變更時自動更新索引
+- **跨平台**：原生作業系統檔案系統監控 (inotify、FSEvents、ReadDirectoryChangesW)
+- **智慧防抖**：批次處理快速變更以防止過度重建（預設：6 秒）
+- **執行緒安全**：使用 ThreadPoolExecutor 進行非阻塞背景操作
+
 ### ⚡ **效能與效率**
 - **智慧索引**：遞迴掃描並智慧篩選建構目錄
 - **持久快取**：儲存索引以實現超快速的後續存取
@@ -128,7 +134,7 @@
 
 在任何相容 MCP 的應用程式中開始使用的最簡單方法：
 
-**先決條件：** Python 3.10+ 和 [uv](https://github.com/astral-sh/uv) 已安裝
+**先決條件：** Python 3.10+、[uv](https://github.com/astral-sh/uv) 和用於檔案監控的 [watchdog](https://pypi.org/project/watchdog/) 已安裝
 
 1. **新增到您的 MCP 配置**（例如 `claude_desktop_config.json` 或 `~/.claude.json`）：
    ```json
@@ -211,6 +217,12 @@ pip install code-index-mcp
 | **`find_files`** | 使用萬用字元模式尋找檔案（例如 `**/*.py`） |
 | **`get_file_summary`** | 分析檔案結構、函式、匯入和複雜度 |
 
+### 🔄 **監控與自動刷新**
+| 工具 | 描述 |
+|------|------|
+| **`get_file_watcher_status`** | 檢查檔案監控器狀態和配置 |
+| **`configure_file_watcher`** | 啟用/停用自動刷新並配置設定 |
+
 ### 🛠️ **系統與維護**
 | 工具 | 描述 |
 |------|------|
@@ -273,6 +285,16 @@ pip install code-index-mcp
 
 </details>
 
+<details>
+<summary><strong>自動刷新配置</strong></summary>
+
+```
+配置檔案變更時的自動索引更新
+```
+*使用：`configure_file_watcher` 啟用/停用監控並設定防抖時間*
+
+</details>
+
 <details>
 <summary><strong>專案維護</strong></summary>