cocoindex-code 0.1.10__tar.gz → 0.1.11__tar.gz

{cocoindex_code-0.1.10 → cocoindex_code-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cocoindex-code
-Version: 0.1.10
+Version: 0.1.11
 Summary: MCP server for indexing and querying codebases using CocoIndex
 Project-URL: Homepage, https://github.com/cocoindex-io/cocoindex-code
 Project-URL: Repository, https://github.com/cocoindex-io/cocoindex-code
@@ -123,7 +123,17 @@ Or use opencode.json:
 }
 ```
 
-Optionally, you can run `cocoindex-code index` to create or update the index. Without running it, the MCP server will automatically build and keep the index up-to-date in the background.
+### Build the Index
+
+For large codebases, we recommend running the indexer once before using the MCP so you can see the progress:
+
+```bash
+cocoindex-code index
+```
+
+This lets you monitor the indexing process and ensure everything is ready. After the initial build, the MCP server will automatically keep the index up-to-date in the background as files change.
+
+For small projects you can skip this step — the MCP server will build the index automatically on first use.
 
 ## When Is the MCP Triggered?
 
@@ -298,7 +308,7 @@ claude mcp add cocoindex-code \
   -- cocoindex-code
 ```
 
-> **Note:** Switching models requires re-indexing your codebase (the vector dimensions differ).
+**Note:** Switching models requires re-indexing your codebase (the vector dimensions differ).
 
 ## MCP Tools
 

{cocoindex_code-0.1.10 → cocoindex_code-0.1.11}/README.md

@@ -88,7 +88,17 @@ Or use opencode.json:
 }
 ```
 
-Optionally, you can run `cocoindex-code index` to create or update the index. Without running it, the MCP server will automatically build and keep the index up-to-date in the background.
+### Build the Index
+
+For large codebases, we recommend running the indexer once before using the MCP so you can see the progress:
+
+```bash
+cocoindex-code index
+```
+
+This lets you monitor the indexing process and ensure everything is ready. After the initial build, the MCP server will automatically keep the index up-to-date in the background as files change.
+
+For small projects you can skip this step — the MCP server will build the index automatically on first use.
 
 ## When Is the MCP Triggered?
 
@@ -263,7 +273,7 @@ claude mcp add cocoindex-code \
   -- cocoindex-code
 ```
 
-> **Note:** Switching models requires re-indexing your codebase (the vector dimensions differ).
+**Note:** Switching models requires re-indexing your codebase (the vector dimensions differ).
 
 ## MCP Tools
 

cocoindex_code-0.1.11/src/cocoindex_code/__init__.py

@@ -0,0 +1,11 @@
+"""CocoIndex Code - MCP server for indexing and querying codebases."""
+
+import logging
+
+logging.basicConfig(level=logging.WARNING)
+
+from .config import Config  # noqa: E402
+from .server import main, mcp  # noqa: E402
+
+__version__ = "0.1.0"
+__all__ = ["Config", "main", "mcp"]

{cocoindex_code-0.1.10 → cocoindex_code-0.1.11}/src/cocoindex_code/server.py

@@ -30,6 +30,9 @@ mcp = FastMCP(
 # Lock to prevent concurrent index updates
 _index_lock = asyncio.Lock()
 
+# Event set once the initial background index is ready
+_initial_index_done = asyncio.Event()
+
 
 async def _refresh_index() -> None:
     """Refresh the index. Uses lock to prevent concurrent updates."""
@@ -123,6 +126,16 @@ async def search(
     ),
 ) -> SearchResultModel:
     """Query the codebase index."""
+    if not _initial_index_done.is_set():
+        return SearchResultModel(
+            success=False,
+            message=(
+                "The index is still being built — this may take a while"
+                " for a large codebase or after significant changes."
+                " Please try again shortly."
+            ),
+        )
+
     try:
         # Refresh index if requested
         if refresh_index:
@@ -167,8 +180,15 @@ async def search(
 
 async def _async_serve() -> None:
     """Async entry point for the MCP server."""
+
     # Refresh index in background so startup isn't blocked
-    asyncio.create_task(_refresh_index())
+    async def _initial_index() -> None:
+        try:
+            await _refresh_index()
+        finally:
+            _initial_index_done.set()
+
+    asyncio.create_task(_initial_index())
     await mcp.run_stdio_async()
 
 

cocoindex_code-0.1.10/src/cocoindex_code/__init__.py

@@ -1,7 +0,0 @@
-"""CocoIndex Code - MCP server for indexing and querying codebases."""
-
-from .config import Config
-from .server import main, mcp
-
-__version__ = "0.1.0"
-__all__ = ["Config", "main", "mcp"]