feat(server): bootstrap project path from cli

Author: johnhuang316

README.md

@@ -41,6 +41,9 @@ The easiest way to get started with any MCP-compatible application:
      }
    }
    ```
+   > Optional: append `--project-path /absolute/path/to/repo` to the `args` array so the server
+   > initializes with that repository automatically (equivalent to calling `set_project_path`
+   > after startup).
 
 2. **Restart your application** – `uvx` automatically handles installation and execution
 
@@ -51,6 +54,8 @@ The easiest way to get started with any MCP-compatible application:
    Search for "authentication" functions
    Analyze the main App.tsx file
    ```
+   *If you launch with `--project-path`, you can skip the first command above - the server already
+   knows the project location.*
 
 ### Codex CLI Configuration
 
@@ -63,6 +68,8 @@ type = "stdio"
 command = "uvx"
 args = ["code-index-mcp"]
 ```
+> You can append `--project-path C:/absolute/path/to/repo` to the `args` list to set the project
+> automatically on startup (same effect as running the `set_project_path` tool).
 
 On Windows, `uvx` needs the standard profile directories to be present.
 Keep the environment override in the same block so the MCP starts reliably:

README_ja.md

@@ -42,6 +42,9 @@ Code Index MCPは、AIモデルと複雑なコードベースの橋渡しをす
    }
    ```
 
+   > 起動時にプロジェクトを自動設定したい場合は、`args` 配列の末尾に
+   > `--project-path /absolute/path/to/repo` を追加してください。これで起動直後に
+   > `set_project_path` を呼び出した場合と同じ状態になります。
 2. **アプリケーションを再起動** – `uvx`がインストールと実行を自動処理
 
 3. **使用開始**（AIアシスタントにこれらのプロンプトを与える）：
@@ -51,6 +54,7 @@ Code Index MCPは、AIモデルと複雑なコードベースの橋渡しをす
    「authentication」関連関数を検索
    メインのApp.tsxファイルを解析
    ```
+   *起動時に `--project-path` を付けた場合は、最初のコマンドは不要です。サーバーが既にパスを認識しています。*
 
 ### Codex CLI 設定
 
@@ -63,6 +67,8 @@ type = "stdio"
 command = "uvx"
 args = ["code-index-mcp"]
 ```
+> 起動時にプロジェクトを設定したい場合は、`args` リストに `--project-path C:/absolute/path/to/repo` を追加してください。
+> これは起動後に `set_project_path` ツールを呼び出すのと同じ効果です。
 
 Windows の `uvx` は標準ユーザープロファイルディレクトリが必要です。
 MCP を安定して起動するために、同じブロックに次の環境変数を残してください。

README_ko.md

@@ -42,6 +42,8 @@ Code Index MCP는 [Model Context Protocol](https://modelcontextprotocol.io) 기
    }
    ```
 
+   > 시작할 때 프로젝트를 자동으로 지정하려면 `args` 배열 끝에
+   > `--project-path /absolute/path/to/repo` 를 추가하세요. 이렇게 하면 시작 직후 `set_project_path` 를 호출한 것과 동일한 상태가 됩니다.
 2. **애플리케이션 재시작** – `uvx`가 설치와 실행을 자동으로 처리합니다.
 
 3. **사용 시작** (AI 어시스턴트에게 아래 프롬프트를 전달)
@@ -51,6 +53,7 @@ Code Index MCP는 [Model Context Protocol](https://modelcontextprotocol.io) 기
    "authentication" 관련 함수를 검색해줘
    src/App.tsx 파일을 분석해줘
    ```
+   *실행 시 `--project-path` 옵션을 사용했다면 첫 번째 명령은 건너뛰어도 됩니다. 서버가 이미 경로를 알고 있습니다.*
 
 ### Codex CLI 설정
 
@@ -63,6 +66,8 @@ type = "stdio"
 command = "uvx"
 args = ["code-index-mcp"]
 ```
+> 실행 시 프로젝트를 자동으로 지정하려면 `args` 리스트에 `--project-path C:/absolute/path/to/repo` 를 추가하세요.
+> 이는 이후에 `set_project_path` 도구를 호출하는 것과 같은 효과입니다.
 
 Windows의 `uvx`는 기본 사용자 프로필 디렉터리가 필요합니다.
 MCP가 안정적으로 시작되도록 같은 블록에 아래 환경 변수 덮어쓰기를 유지하세요.

README_zh.md

@@ -41,6 +41,8 @@
      }
    }
    ```
+   > 若想在啟動時自動設定專案路徑，可在 `args` 陣列末尾加入
+   > `--project-path /絕對/路徑`，效果等同於啟動後呼叫 `set_project_path`。
 
 2. **重新啟動應用程式** – `uvx` 會自動處理安裝和執行
 
@@ -51,6 +53,7 @@
    搜尋「authentication」相關函數
    分析主要的 App.tsx 檔案
    ```
+   *如果啟動時已提供 `--project-path`，可以略過第一個指令，伺服器會自動記住路徑。*
 
 ### Codex CLI 設定
 
@@ -63,6 +66,8 @@ type = "stdio"
 command = "uvx"
 args = ["code-index-mcp"]
 ```
+> 如需要啟動時自動設定專案，請把 `--project-path C:/絕對/路徑` 加到 `args`
+> 清單中，與手動呼叫 `set_project_path` 的結果相同。
 
 在 Windows 中，`uvx` 需要找到標準的使用者目錄。保留下列環境變數覆寫設定，才能讓 MCP 穩定啟動：
 

src/code_index_mcp/server.py

@@ -9,6 +9,8 @@
 """
 
 # Standard library imports
+import argparse
+import inspect
 import sys
 import logging
 from contextlib import asynccontextmanager
@@ -52,6 +54,7 @@ def setup_indexing_performance_logging():
 
 # Initialize logging (no file handlers)
 setup_indexing_performance_logging()
+logger = logging.getLogger(__name__)
 
 @dataclass
 class CodeIndexerContext:
@@ -61,6 +64,24 @@ class CodeIndexerContext:
     file_count: int = 0
     file_watcher_service: FileWatcherService = None
 
+
+@dataclass
+class _CLIConfig:
+    """Holds CLI configuration for bootstrap operations."""
+    project_path: str | None = None
+
+
+class _BootstrapRequestContext:
+    """Minimal request context to reuse business services during bootstrap."""
+
+    def __init__(self, lifespan_context: CodeIndexerContext):
+        self.lifespan_context = lifespan_context
+        self.session = None
+        self.meta = None
+
+
+_CLI_CONFIG = _CLIConfig()
+
 @asynccontextmanager
 async def indexer_lifespan(_server: FastMCP) -> AsyncIterator[CodeIndexerContext]:
     """Manage the lifecycle of the Code Indexer MCP server."""
@@ -78,6 +99,23 @@ async def indexer_lifespan(_server: FastMCP) -> AsyncIterator[CodeIndexerContext
     )
 
     try:
+        # Bootstrap project path when provided via CLI.
+        if _CLI_CONFIG.project_path:
+            bootstrap_ctx = Context(
+                request_context=_BootstrapRequestContext(context),
+                fastmcp=mcp
+            )
+            try:
+                message = ProjectManagementService(bootstrap_ctx).initialize_project(
+                    _CLI_CONFIG.project_path
+                )
+                logger.info("Project initialized from CLI flag: %s", message)
+            except Exception as exc:  # pylint: disable=broad-except
+                logger.error("Failed to initialize project from CLI flag: %s", exc)
+                raise RuntimeError(
+                    f"Failed to initialize project path '{_CLI_CONFIG.project_path}'"
+                ) from exc
+
         # Provide context to the server
         yield context
     finally:
@@ -300,9 +338,55 @@ def configure_file_watcher(
 # ----- PROMPTS -----
 # Removed: analyze_code, code_search, set_project prompts
 
-def main():
+def _parse_args(argv: list[str] | None = None) -> argparse.Namespace:
+    """Parse CLI arguments for the MCP server."""
+    parser = argparse.ArgumentParser(description="Code Index MCP server")
+    parser.add_argument(
+        "--project-path",
+        dest="project_path",
+        help="Set the project path on startup (equivalent to calling set_project_path)."
+    )
+    parser.add_argument(
+        "--transport",
+        choices=["stdio", "sse", "streamable-http"],
+        default="stdio",
+        help="Transport protocol to use (default: stdio)."
+    )
+    parser.add_argument(
+        "--mount-path",
+        dest="mount_path",
+        default=None,
+        help="Mount path when using SSE transport."
+    )
+    return parser.parse_args(argv)
+
+
+def main(argv: list[str] | None = None):
     """Main function to run the MCP server."""
-    mcp.run()
+    args = _parse_args(argv)
+
+    # Store CLI configuration for lifespan bootstrap.
+    _CLI_CONFIG.project_path = args.project_path
+
+    run_kwargs = {"transport": args.transport}
+    if args.transport == "sse" and args.mount_path:
+        run_signature = inspect.signature(mcp.run)
+        if "mount_path" in run_signature.parameters:
+            run_kwargs["mount_path"] = args.mount_path
+        else:
+            logger.warning(
+                "Ignoring --mount-path because this FastMCP version "
+                "does not accept the parameter."
+            )
+
+    try:
+        mcp.run(**run_kwargs)
+    except RuntimeError as exc:
+        logger.error("MCP server terminated with error: %s", exc)
+        raise SystemExit(1) from exc
+    except Exception as exc:  # pylint: disable=broad-except
+        logger.error("Unexpected MCP server error: %s", exc)
+        raise
 
 if __name__ == '__main__':
     main()