python-docs-mcp-server 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

mcp_server_python_docs/server.py

@@ -9,7 +9,9 @@ from __future__ import annotations
 import asyncio
 import importlib.resources
 import logging
+import os
 import sqlite3
+import subprocess
 import sys
 import traceback
 from collections.abc import AsyncIterator
@@ -61,6 +63,55 @@ def _assert_fts5(conn: sqlite3.Connection) -> None:
     assert_fts5_available(conn)
 
 
+def _auto_build_symbol_index(index_path) -> bool:
+    """Build a small symbol-only index when the server starts without one.
+
+    This keeps hosted scanners/directories such as Glama from failing MCP
+    introspection on a fresh container while preserving the documented full
+    corpus command for normal users. Set PYTHON_DOCS_MCP_DISABLE_AUTO_INDEX=1
+    to require an explicitly prebuilt index.
+    """
+    if os.environ.get("PYTHON_DOCS_MCP_DISABLE_AUTO_INDEX") == "1":
+        return False
+
+    versions = os.environ.get("PYTHON_DOCS_MCP_AUTO_INDEX_VERSIONS", "3.13")
+    logger.warning(
+        "No index found at %s; auto-building symbol-only Python docs index for %s",
+        index_path,
+        versions,
+    )
+    try:
+        result = subprocess.run(
+            [
+                sys.executable,
+                "-m",
+                "mcp_server_python_docs",
+                "build-index",
+                "--versions",
+                versions,
+                "--skip-content",
+            ],
+            check=False,
+            capture_output=True,
+            text=True,
+            timeout=180,
+        )
+    except (OSError, subprocess.TimeoutExpired) as e:
+        logger.error("Auto index build failed to start or timed out: %s", e)
+        return False
+
+    if result.returncode != 0:
+        logger.error(
+            "Auto index build failed with exit code %s:\n%s",
+            result.returncode,
+            (result.stderr or result.stdout)[-4000:],
+        )
+        return False
+
+    logger.info("Auto index build complete at %s", index_path)
+    return index_path.exists()
+
+
 @asynccontextmanager
 async def app_lifespan(server: FastMCP) -> AsyncIterator[AppContext]:
     """Manage application lifecycle with typed context (SRVR-01).
@@ -72,8 +123,9 @@ async def app_lifespan(server: FastMCP) -> AsyncIterator[AppContext]:
     cache_dir = get_cache_dir()
     index_path = get_index_path()
 
-    # Fail fast on missing index (SRVR-10)
-    if not index_path.exists():
+    # Fail fast on missing index unless a small symbol-only auto-index succeeds
+    # (SRVR-10 plus hosted-directory scanner compatibility).
+    if not index_path.exists() and not _auto_build_symbol_index(index_path):
         from mcp_server_python_docs.ingestion.cpython_versions import (
             SUPPORTED_DOC_VERSIONS_CSV,
         )

{python_docs_mcp_server-0.1.2.dist-info → python_docs_mcp_server-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-docs-mcp-server
-Version: 0.1.2
+Version: 0.1.3
 Summary: A read-only, version-aware MCP retrieval server over Python standard library documentation
 Author-email: Aymen Hammouda <hammouda.aymen@gmail.com>
 License-Expression: MIT

{python_docs_mcp_server-0.1.2.dist-info → python_docs_mcp_server-0.1.3.dist-info}/RECORD

@@ -6,7 +6,7 @@ mcp_server_python_docs/diagnostics.py,sha256=FyC6QDFLvozARpYuMnaKfJwaN6BCzVycME_
 mcp_server_python_docs/errors.py,sha256=XTOm1raJfxS2adaOPZdwj0SuhpMAXAdjBsF2-zTv_1E,827
 mcp_server_python_docs/models.py,sha256=jtC1TEAOZHBDEfFf8uqsSzC5FKmY06zRrHWzw3HSmsg,6966
 mcp_server_python_docs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mcp_server_python_docs/server.py,sha256=-5ib1gZ35iOmJcj98EpwhF22JwbU0YEcL0Sy3mpHTdE,12057
+mcp_server_python_docs/server.py,sha256=z1FwWz6ivJVbvN4CYugCKABYTY2Bg_QCuBqZRjdxAVk,13835
 mcp_server_python_docs/data/synonyms.yaml,sha256=LgJxamZ9QT6Pykva7M1uM8juSd9ybHuv3vUOKrUFMg4,10696
 mcp_server_python_docs/ingestion/__init__.py,sha256=Yd7Jk7hD7XG3eoBVQpYiG94EwJGfI3qXxVCpA8JszYg,66
 mcp_server_python_docs/ingestion/cpython_versions.py,sha256=mEhjuT7q8Bo1aZ-zj6PSqmbq2Bz64g4xj50ttqA4QUU,977
@@ -29,8 +29,8 @@ mcp_server_python_docs/services/version_resolution.py,sha256=rULBoqq97t0ZfSWSy-e
 mcp_server_python_docs/storage/__init__.py,sha256=YNeNr7FW9Vgvo79oXgKXE3eGP0WwWDqRgTZ7lg7MFW4,62
 mcp_server_python_docs/storage/db.py,sha256=Lys8HN3IvgmNpr_qyocUQghcZnwHf2lz9eq_BFmwi54,5634
 mcp_server_python_docs/storage/schema.sql,sha256=4cXPktPQSLfbjkSjirpf0dA2CphlO9UCIKUxnLiIm_g,5637
-python_docs_mcp_server-0.1.2.dist-info/METADATA,sha256=zPlrnZCtL0lq18iANDS3EMTV0-jcfrh_E_BFvp3saAU,16977
-python_docs_mcp_server-0.1.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-python_docs_mcp_server-0.1.2.dist-info/entry_points.txt,sha256=-1arbtjZhF5mtnJNAh_90UBr1f4AqJxT3Tmfy9p7NMI,142
-python_docs_mcp_server-0.1.2.dist-info/licenses/LICENSE,sha256=-AHGWRwcvoeP4bkY1W2ok_qaI1Mg0Zx2qYgR1k-3CHY,1071
-python_docs_mcp_server-0.1.2.dist-info/RECORD,,
+python_docs_mcp_server-0.1.3.dist-info/METADATA,sha256=9p96MUOdzeXdbZ8xAbRGVHL_sVKpXpVzZgmTJT-9gfU,16977
+python_docs_mcp_server-0.1.3.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+python_docs_mcp_server-0.1.3.dist-info/entry_points.txt,sha256=-1arbtjZhF5mtnJNAh_90UBr1f4AqJxT3Tmfy9p7NMI,142
+python_docs_mcp_server-0.1.3.dist-info/licenses/LICENSE,sha256=-AHGWRwcvoeP4bkY1W2ok_qaI1Mg0Zx2qYgR1k-3CHY,1071
+python_docs_mcp_server-0.1.3.dist-info/RECORD,,