chore: update README files for multilingual support

Author: johnhuang316

README.md

@@ -22,36 +22,69 @@ Code Index MCP is a [Model Context Protocol](https://modelcontextprotocol.io) se
 
 **Perfect for:** Code review, refactoring, documentation generation, debugging assistance, and architectural analysis.
 
+## Quick Start
+
+### 🚀 **Recommended Setup (Most Users)**
+
+The easiest way to get started with any MCP-compatible application:
+
+**Prerequisites:** Python 3.10+ and [uv](https://github.com/astral-sh/uv)
+
+1. **Add to your MCP configuration** (e.g., `claude_desktop_config.json` or `~/.claude.json`):
+   ```json
+   {
+     "mcpServers": {
+       "code-index": {
+         "command": "uvx",
+         "args": ["code-index-mcp"]
+       }
+     }
+   }
+   ```
+
+2. **Restart your application** – `uvx` automatically handles installation and execution
+
+3. **Start using**:
+   ```
+   Set the project path to /Users/dev/my-react-app
+   Find all TypeScript files in this project  
+   Search for "authentication" functions
+   Analyze the main App.tsx file
+   ```
+
+## Typical Use Cases
+
+**Code Review**: "Find all places using the old API"  
+**Refactoring Help**: "Where is this function called?"  
+**Learning Projects**: "Show me the main components of this React project"  
+**Debugging**: "Search for all error handling related code"
+
 ## Key Features
 
 ### 🔍 **Intelligent Search & Analysis**
+- **SCIP-Powered**: Industry-standard code intelligence format used by major IDEs
 - **Advanced Search**: Auto-detects and uses the best available tool (ugrep, ripgrep, ag, or grep)
-- **Regex Support**: Full regex pattern matching with ReDoS attack prevention
-- **Fuzzy Search**: True fuzzy matching with edit distance (ugrep) or word boundary patterns
+- **Universal Understanding**: Single system comprehends all programming languages
 - **File Analysis**: Deep insights into structure, imports, classes, methods, and complexity metrics
 
-### 🗂️ **Multi-Language Support**
-- **Mainstream Languages**: Java, Python, JavaScript/TypeScript, C/C++, Go, Rust, C#
-- **Mobile Development**: Swift, Kotlin, Objective-C/C++, React Native
-- **Web Frontend**: Vue, React, Svelte, Astro, HTML, CSS, SCSS
-- **Database**: SQL (MySQL, PostgreSQL, SQLite), NoSQL, stored procedures, migrations
-- **Scripting**: Ruby, PHP, Shell, PowerShell, Bash
-- **Systems**: C/C++, Rust, Go, Zig
-- **JVM Ecosystem**: Java, Kotlin, Scala, Groovy
-- **Others**: Lua, Perl, R, MATLAB, configuration files
-- **50+ File Types Total** - [View complete list](#supported-file-types)
+### 🗂️ **Multi-Language Support**  
+- **50+ File Types**: Java, Python, JavaScript/TypeScript, C/C++, Go, Rust, C#, Swift, Kotlin, Ruby, PHP, and more
+- **Web Frontend**: Vue, React, Svelte, HTML, CSS, SCSS
+- **Database**: SQL variants, NoSQL, stored procedures, migrations
+- **Configuration**: JSON, YAML, XML, Markdown
+- **[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
+- **Cross-platform**: Native OS file system monitoring
+- **Smart Processing**: Batches rapid changes to prevent excessive rebuilds
+- **Rich Metadata**: Captures symbols, references, definitions, and relationships
 
 ### ⚡ **Performance & Efficiency**
-- **Smart Indexing**: Recursively scans with intelligent filtering of build directories
+- **SCIP Indexing**: Fast protobuf-based unified indexing system
 - **Persistent Caching**: Stores indexes for lightning-fast subsequent access
-- **Lazy Loading**: Tools detected only when needed for optimal startup
-- **Memory Efficient**: Intelligent caching strategies for large codebases
+- **Smart Filtering**: Intelligent exclusion of build directories and temporary files
+- **Memory Efficient**: Optimized for large codebases
 
 ## Supported File Types
 
@@ -128,28 +161,6 @@ Code Index MCP is a [Model Context Protocol](https://modelcontextprotocol.io) se
 
 </details>
 
-## Quick Start
-
-### 🚀 **Recommended Setup (Most Users)**
-
-The easiest way to get started with any MCP-compatible application:
-
-**Prerequisites:** Python 3.10+ and [uv](https://github.com/astral-sh/uv)
-
-1. **Add to your MCP configuration** (e.g., `claude_desktop_config.json` or `~/.claude.json`):
-   ```json
-   {
-     "mcpServers": {
-       "code-index": {
-         "command": "uvx",
-         "args": ["code-index-mcp"]
-       }
-     }
-   }
-   ```
-
-2. **Restart your application** – `uvx` automatically handles installation and execution
-
 ### 🛠️ **Development Setup**
 
 For contributing or local development:

README_ja.md

@@ -22,30 +22,63 @@ Code Index MCPは、AIモデルと複雑なコードベースの橋渡しをす
 
 **最適な用途：**コードレビュー、リファクタリング、ドキュメント生成、デバッグ支援、アーキテクチャ解析。
 
+## クイックスタート
+
+### 🚀 **推奨セットアップ（ほとんどのユーザー）**
+
+任意MCP対応アプリケーションで開始する最も簡単な方法：
+
+**前提条件：** Python 3.10+ および [uv](https://github.com/astral-sh/uv)
+
+1. **MCP設定に追加** (例：`claude_desktop_config.json` または `~/.claude.json`)：
+   ```json
+   {
+     "mcpServers": {
+       "code-index": {
+         "command": "uvx",
+         "args": ["code-index-mcp"]
+       }
+     }
+   }
+   ```
+
+2. **アプリケーションを再起動** – `uvx`がインストールと実行を自動処理
+
+3. **使用開始**：
+   ```
+   プロジェクトパスを/Users/dev/my-react-appに設定
+   このプロジェクトのすべてのTypeScriptファイルを検索
+   「authentication」関連関数を検索
+   メインのApp.tsxファイルを解析
+   ```
+
+## 一般的な使用ケース
+
+**コードレビュー**：「旧いAPIを使用しているすべての箇所を検索」  
+**リファクタリング支援**：「この関数はどこで呼ばれている？」  
+**プロジェクト学習**：「このReactプロジェクトの主要コンポーネントを表示」  
+**デバッグ支援**：「エラーハンドリング関連のコードをすべて検索」
+
 ## 主な機能
 
 ### 🔍 **インテリジェント検索・解析**
+- **SCIPパワー**：主要IDEで使用される業界標準コードインテリジェンスフォーマット
 - **高度な検索**：最適なツール（ugrep、ripgrep、ag、grep）を自動検出・使用
-- **正規表現サポート**：ReDoS攻撃防御付きの完全な正規表現パターンマッチング
-- **ファジー検索**：真の編集距離ファジーマッチング（ugrep）または単語境界パターンマッチング
+- **汎用理解**：単一システムですべてのプログラミング言語を理解
 - **ファイル解析**：構造、インポート、クラス、メソッド、複雑度メトリクスへの深い洞察
 
 ### 🗂️ **多言語サポート**
-- **主流言語**：Java、Python、JavaScript/TypeScript、C/C++、Go、Rust、C#
-- **モバイル開発**：Swift、Kotlin、Objective-C/C++、React Native
-- **Webフロントエンド**：Vue、React、Svelte、Astro、HTML、CSS、SCSS
-- **データベース**：SQL (MySQL、PostgreSQL、SQLite)、NoSQL、ストアドプロシージャ、マイグレーション
-- **スクリプト言語**：Ruby、PHP、Shell、PowerShell、Bash
-- **システム言語**：C/C++、Rust、Go、Zig
-- **JVMエコシステム**：Java、Kotlin、Scala、Groovy
-- **その他の言語**：Lua、Perl、R、MATLAB、設定ファイル
-- **合計50+ファイルタイプ** - [完全なリストを表示](#サポートされているファイルタイプ)
+- **50+ファイルタイプ**：Java、Python、JavaScript/TypeScript、C/C++、Go、Rust、C#、Swift、Kotlin、Ruby、PHPなど
+- **Webフロントエンド**：Vue、React、Svelte、HTML、CSS、SCSS
+- **データベース**：SQLバリアント、NoSQL、ストアドプロシージャ、マイグレーション
+- **設定ファイル**：JSON、YAML、XML、Markdown
+- **[完全なリストを表示](#サポートされているファイルタイプ)**
 
 ### ⚡ **リアルタイム監視・自動更新**
 - **ファイルウォッチャー**：ファイル変更時の自動インデックス更新
-- **クロスプラットフォーム**：ネイティブOS ファイルシステム監視 (inotify、FSEvents、ReadDirectoryChangesW)
-- **スマートデバウンス**：急速な変更をバッチ処理して過度な再構築を防止（デフォルト：6秒）
-- **スレッドセーフ**：ThreadPoolExecutor による非ブロッキングバックグラウンド操作
+- **クロスプラットフォーム**：ネイティブOSファイルシステム監視
+- **スマート処理**：急速な変更をバッチ処理して過度な再構築を防止
+- **豊富なメタデータ**：シンボル、参照、定義、関連性をキャプチャ
 
 ### ⚡ **パフォーマンス・効率性**
 - **スマートインデックス作成**：ビルドディレクトリをインテリジェントにフィルタリングしながら再帰的スキャン

README_zh.md

@@ -22,30 +22,63 @@
 
 **適用於：**程式碼審查、重構、文件生成、除錯協助和架構分析。
 
+## 快速開始
+
+### 🚀 **推薦設定（大多數使用者）**
+
+與任何 MCP 相容應用程式開始的最簡單方式：
+
+**前置需求：** Python 3.10+ 和 [uv](https://github.com/astral-sh/uv)
+
+1. **新增到您的 MCP 設定** (例如 `claude_desktop_config.json` 或 `~/.claude.json`)：
+   ```json
+   {
+     "mcpServers": {
+       "code-index": {
+         "command": "uvx",
+         "args": ["code-index-mcp"]
+       }
+     }
+   }
+   ```
+
+2. **重新啟動應用程式** – `uvx` 會自動處理安裝和執行
+
+3. **開始使用**：
+   ```
+   設定專案路徑為 /Users/dev/my-react-app
+   在這個專案中找到所有 TypeScript 檔案
+   搜尋「authentication」相關函數
+   分析主要的 App.tsx 檔案
+   ```
+
+## 典型使用場景
+
+**程式碼審查**：「找出所有使用舊 API 的地方」  
+**重構協助**：「這個函數在哪裡被呼叫？」  
+**學習專案**：「顯示這個 React 專案的主要元件」  
+**除錯協助**：「搜尋所有錯誤處理相關的程式碼」
+
 ## 主要特性
 
 ### 🔍 **智慧搜尋與分析**
+- **SCIP 驅動**：業界標準程式碼智能格式，被主流 IDE 採用
 - **進階搜尋**：自動偵測並使用最佳工具（ugrep、ripgrep、ag 或 grep）
-- **正規表達式支援**：完整的正規表達式模式匹配，具備 ReDoS 攻擊防護
-- **模糊搜尋**：真正的編輯距離模糊匹配（ugrep）或詞邊界模式匹配
+- **通用理解**：單一系統理解所有程式語言
 - **檔案分析**：深入了解結構、匯入、類別、方法和複雜度指標
 
 ### 🗂️ **多語言支援**
-- **主流語言**：Java、Python、JavaScript/TypeScript、C/C++、Go、Rust、C#
-- **行動開發**：Swift、Kotlin、Objective-C/C++、React Native
-- **網頁前端**：Vue、React、Svelte、Astro、HTML、CSS、SCSS
-- **資料庫**：SQL (MySQL、PostgreSQL、SQLite)、NoSQL、存儲過程、遷移腳本
-- **腳本語言**：Ruby、PHP、Shell、PowerShell、Bash
-- **系統語言**：C/C++、Rust、Go、Zig
-- **JVM 生態系**：Java、Kotlin、Scala、Groovy
-- **其他語言**：Lua、Perl、R、MATLAB、配置檔案
-- **共 50+ 種檔案類型** - [查看完整列表](#支援的檔案類型)
+- **50+ 種檔案類型**：Java、Python、JavaScript/TypeScript、C/C++、Go、Rust、C#、Swift、Kotlin、Ruby、PHP 等
+- **網頁前端**：Vue、React、Svelte、HTML、CSS、SCSS
+- **資料庫**：SQL 變體、NoSQL、存儲過程、遷移腳本
+- **配置檔案**：JSON、YAML、XML、Markdown
+- **[查看完整列表](#支援的檔案類型)**
 
 ### ⚡ **即時監控與自動刷新**
 - **檔案監控器**：檔案變更時自動更新索引
-- **跨平台**：原生作業系統檔案系統監控 (inotify、FSEvents、ReadDirectoryChangesW)
-- **智慧防抖**：批次處理快速變更以防止過度重建（預設：6 秒）
-- **執行緒安全**：使用 ThreadPoolExecutor 進行非阻塞背景操作
+- **跨平台**：原生作業系統檔案系統監控
+- **智慧處理**：批次處理快速變更以防止過度重建
+- **豐富元資料**：捕獲符號、引用、定義和關聯性
 
 ### ⚡ **效能與效率**
 - **智慧索引**：遞迴掃描並智慧篩選建構目錄