python-docs-mcp-server 0.1.2__tar.gz → 0.1.4__tar.gz

{python_docs_mcp_server-0.1.2 → python_docs_mcp_server-0.1.4}/.github/workflows/ci.yml

@@ -18,10 +18,12 @@ jobs:
     name: Test (Python ${{ matrix.python-version }}, ${{ matrix.os }})
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v4
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          cache-suffix: py${{ matrix.python-version }}
 
       - name: Set up Python ${{ matrix.python-version }}
         run: uv python install ${{ matrix.python-version }}

{python_docs_mcp_server-0.1.2 → python_docs_mcp_server-0.1.4}/.github/workflows/e2e.yml

@@ -17,10 +17,12 @@ jobs:
         python-version: ["3.13", "3.14"]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v4
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          cache-suffix: py${{ matrix.python-version }}
 
       - name: Set up Python ${{ matrix.python-version }}
         run: uv python install ${{ matrix.python-version }}
@@ -48,7 +50,7 @@ jobs:
 
       - name: Upload E2E logs and cache artifacts
         if: always()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: e2e-python-${{ matrix.python-version }}
           path: |

{python_docs_mcp_server-0.1.2 → python_docs_mcp_server-0.1.4}/.github/workflows/release.yml

@@ -16,10 +16,10 @@ jobs:
     timeout-minutes: 15
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v4
+        uses: astral-sh/setup-uv@v8.1.0
 
       - name: Set up Python 3.13
         run: uv python install 3.13
@@ -35,6 +35,16 @@ jobs:
             echo "::error::Tag ${GITHUB_REF_NAME} does not match pyproject.toml version ${PKG_VERSION}"
             exit 1
           fi
+          SERVER_VERSION=$(uv run python -c "import json; print(json.load(open('server.json'))['version'])")
+          PACKAGE_VERSION=$(uv run python -c "import json; print(json.load(open('server.json'))['packages'][0]['version'])")
+          if [ "$TAG_VERSION" != "$SERVER_VERSION" ]; then
+            echo "::error::Tag ${GITHUB_REF_NAME} does not match server.json version ${SERVER_VERSION}"
+            exit 1
+          fi
+          if [ "$TAG_VERSION" != "$PACKAGE_VERSION" ]; then
+            echo "::error::Tag ${GITHUB_REF_NAME} does not match server.json package version ${PACKAGE_VERSION}"
+            exit 1
+          fi
           echo "Version check passed: ${PKG_VERSION}"
 
       - name: Run linter
@@ -66,7 +76,7 @@ jobs:
           "
 
       - name: Upload dist artifacts
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: dist
           path: dist/
@@ -84,22 +94,50 @@ jobs:
 
     steps:
       - name: Download dist artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           name: dist
           path: dist/
 
       - name: Generate artifact attestation
-        uses: actions/attest-build-provenance@v2
+        uses: actions/attest-build-provenance@v4
         with:
           subject-path: 'dist/*'
 
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
 
-  github-release:
+  publish-mcp-registry:
     needs: publish
     runs-on: ubuntu-latest
+    name: Publish to MCP Registry
+    timeout-minutes: 10
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install mcp-publisher
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" \
+            | tar xz mcp-publisher
+
+      - name: Validate server.json
+        run: ./mcp-publisher validate server.json
+
+      - name: Authenticate to MCP Registry
+        run: ./mcp-publisher login github-oidc
+
+      - name: Publish to MCP Registry
+        run: ./mcp-publisher publish
+
+  github-release:
+    needs:
+      - publish
+      - publish-mcp-registry
+    runs-on: ubuntu-latest
     name: Create GitHub Release
     timeout-minutes: 10
     permissions:
@@ -107,13 +145,13 @@ jobs:
 
     steps:
       - name: Download dist artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           name: dist
           path: dist/
 
       - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v3
         with:
           files: dist/*
           generate_release_notes: true

{python_docs_mcp_server-0.1.2 → python_docs_mcp_server-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-docs-mcp-server
-Version: 0.1.2
+Version: 0.1.4
 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
@@ -31,6 +31,7 @@ Description-Content-Type: text/markdown
 <!-- mcp-name: io.github.ayhammouda/python-docs-mcp-server -->
 
 [![CI](https://github.com/ayhammouda/python-docs-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/ayhammouda/python-docs-mcp-server/actions/workflows/ci.yml)
+[![python-docs-mcp-server MCP server](https://glama.ai/mcp/servers/ayhammouda/python-docs-mcp-server/badges/score.svg)](https://glama.ai/mcp/servers/ayhammouda/python-docs-mcp-server)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/)
 [![No API Keys](https://img.shields.io/badge/API%20keys-none-success)](#why-teams-like-this)

{python_docs_mcp_server-0.1.2 → python_docs_mcp_server-0.1.4}/README.md

@@ -3,6 +3,7 @@
 <!-- mcp-name: io.github.ayhammouda/python-docs-mcp-server -->
 
 [![CI](https://github.com/ayhammouda/python-docs-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/ayhammouda/python-docs-mcp-server/actions/workflows/ci.yml)
+[![python-docs-mcp-server MCP server](https://glama.ai/mcp/servers/ayhammouda/python-docs-mcp-server/badges/score.svg)](https://glama.ai/mcp/servers/ayhammouda/python-docs-mcp-server)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/)
 [![No API Keys](https://img.shields.io/badge/API%20keys-none-success)](#why-teams-like-this)

python_docs_mcp_server-0.1.4/glama.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": [
+    "ayhammouda"
+  ]
+}

{python_docs_mcp_server-0.1.2 → python_docs_mcp_server-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "python-docs-mcp-server"
-version = "0.1.2"
+version = "0.1.4"
 description = "A read-only, version-aware MCP retrieval server over Python standard library documentation"
 readme = "README.md"
 license = "MIT"

{python_docs_mcp_server-0.1.2 → python_docs_mcp_server-0.1.4}/server.json

@@ -8,13 +8,13 @@
     "url": "https://github.com/ayhammouda/python-docs-mcp-server",
     "source": "github"
   },
-  "version": "0.1.1",
+  "version": "0.1.4",
   "packages": [
     {
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "python-docs-mcp-server",
-      "version": "0.1.1",
+      "version": "0.1.4",
       "runtimeHint": "uvx",
       "transport": {
         "type": "stdio"

{python_docs_mcp_server-0.1.2 → python_docs_mcp_server-0.1.4}/src/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 → python_docs_mcp_server-0.1.4}/tests/test_stdio_hygiene.py

@@ -67,12 +67,16 @@ class TestStdioHygiene:
         import tempfile
 
         with tempfile.TemporaryDirectory() as tmpdir:
+            env = {
+                **_isolated_cache_env(tmpdir),
+                "PYTHON_DOCS_MCP_DISABLE_AUTO_INDEX": "1",
+            }
             result = subprocess.run(
                 [sys.executable, "-m", "mcp_server_python_docs", "serve"],
                 capture_output=True,
                 text=True,
                 timeout=10,
-                env=_isolated_cache_env(tmpdir),
+                env=env,
             )
             # Server should exit with error (missing index)
             assert result.returncode != 0

{python_docs_mcp_server-0.1.2 → python_docs_mcp_server-0.1.4}/tests/test_stdio_smoke.py

@@ -16,6 +16,7 @@ import json
 import os
 import subprocess
 import sys
+import threading
 import time
 from pathlib import Path
 
@@ -100,17 +101,17 @@ def _create_test_index(cache_dir: Path) -> Path:
     return db_path
 
 
-def _make_request(method: str, params: dict | None = None, req_id: int = 1) -> bytes:
+def _make_request(method: str, params: dict[str, object] | None = None, req_id: int = 1) -> bytes:
     """Build a JSON-RPC 2.0 request as newline-terminated bytes."""
-    msg = {"jsonrpc": "2.0", "id": req_id, "method": method}
+    msg: dict[str, object] = {"jsonrpc": "2.0", "id": req_id, "method": method}
     if params is not None:
         msg["params"] = params
     return json.dumps(msg).encode() + b"\n"
 
 
-def _make_notification(method: str, params: dict | None = None) -> bytes:
+def _make_notification(method: str, params: dict[str, object] | None = None) -> bytes:
     """Build a JSON-RPC 2.0 notification (no id) as newline-terminated bytes."""
-    msg = {"jsonrpc": "2.0", "method": method}
+    msg: dict[str, object] = {"jsonrpc": "2.0", "method": method}
     if params is not None:
         msg["params"] = params
     return json.dumps(msg).encode() + b"\n"
@@ -170,6 +171,19 @@ def _find_response(responses: list[dict], req_id: int) -> dict | None:
     return None
 
 
+def _request_ids(stdin_data: bytes) -> list[int]:
+    """Return request ids present in newline-delimited JSON-RPC input."""
+    request_ids: list[int] = []
+    for line in stdin_data.splitlines():
+        try:
+            parsed = json.loads(line)
+        except json.JSONDecodeError:
+            continue
+        if isinstance(parsed, dict) and "id" in parsed:
+            request_ids.append(parsed["id"])
+    return request_ids
+
+
 class TestStdioSmoke:
     """Spawn the MCP server as a subprocess and verify protocol compliance."""
 
@@ -192,13 +206,64 @@ class TestStdioSmoke:
             env=self.env,
         )
         assert proc.stdin is not None
-        for index, line in enumerate(stdin_data.splitlines(keepends=True)):
-            proc.stdin.write(line)
-            proc.stdin.flush()
-            time.sleep(0.3 if index == 0 else 0.05)
-        proc.stdin.close()
-        proc.stdin = None
-        stdout, stderr = proc.communicate(timeout=timeout)
+        assert proc.stdout is not None
+        assert proc.stderr is not None
+
+        stdout_lines: list[bytes] = []
+        stderr_lines: list[bytes] = []
+        output_lock = threading.Lock()
+
+        def read_stream(stream, sink: list[bytes]) -> None:
+            for line in iter(stream.readline, b""):
+                with output_lock:
+                    sink.append(line)
+
+        stdout_thread = threading.Thread(
+            target=read_stream,
+            args=(proc.stdout, stdout_lines),
+            daemon=True,
+        )
+        stderr_thread = threading.Thread(
+            target=read_stream,
+            args=(proc.stderr, stderr_lines),
+            daemon=True,
+        )
+        stdout_thread.start()
+        stderr_thread.start()
+
+        expected_ids = _request_ids(stdin_data)
+        deadline = time.monotonic() + timeout
+        try:
+            for line in stdin_data.splitlines(keepends=True):
+                proc.stdin.write(line)
+                proc.stdin.flush()
+
+            while time.monotonic() < deadline:
+                with output_lock:
+                    responses = _read_responses(b"".join(stdout_lines))
+                if all(_find_response(responses, req_id) is not None for req_id in expected_ids):
+                    break
+                if proc.poll() is not None:
+                    break
+                time.sleep(0.02)
+        finally:
+            try:
+                proc.stdin.close()
+            except BrokenPipeError:
+                pass
+            proc.stdin = None
+
+        remaining = max(0.1, deadline - time.monotonic())
+        try:
+            proc.wait(timeout=remaining)
+        except subprocess.TimeoutExpired:
+            proc.kill()
+            proc.wait(timeout=5)
+
+        stdout_thread.join(timeout=1)
+        stderr_thread.join(timeout=1)
+        stdout = b"".join(stdout_lines)
+        stderr = b"".join(stderr_lines)
         return subprocess.CompletedProcess(proc.args, proc.returncode, stdout, stderr)
 
     def test_server_lists_tools_no_stdout_pollution(self):

{python_docs_mcp_server-0.1.2 → python_docs_mcp_server-0.1.4}/uv.lock

@@ -541,7 +541,7 @@ wheels = [
 
 [[package]]
 name = "python-docs-mcp-server"
-version = "0.1.2"
+version = "0.1.4"
 source = { editable = "." }
 dependencies = [
     { name = "beautifulsoup4" },