Fix clean-install MCP SDK incompatibility

.github/workflows/tests.yml

@@ -32,6 +32,12 @@ jobs:
       - name: Run tests (skip slow integration tests)
         run: uv run pytest tests/ -v --tb=short --ignore=tests/test_integration.py
 
+      - name: Smoke-test wheel with clean dependency resolution
+        run: |
+          uv build --wheel --out-dir dist-smoke
+          WHEEL=$(find dist-smoke -name '*.whl' -print -quit)
+          timeout 30s uvx --refresh --from "$WHEEL" paper-intelligence </dev/null
+
   lint:
     name: Lint
     runs-on: ubuntu-latest

CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.5.2] - 2026-08-28
+
+### Fixed
+- Pin the MCP Python SDK below v2 because the server uses the v1 FastMCP API; clean installs no longer resolve an incompatible SDK that crashes at startup.
+- CI now launches the CLI from a freshly built wheel without relying on the repository lockfile.
+
 ## [0.5.1] - 2026-08-28
 
 ### Fixed

paper_intelligence/_version.py

@@ -4,7 +4,7 @@
 
 from typing import Optional
 
-__version__ = "0.5.1"
+__version__ = "0.5.2"
 
 # Version compatibility rules:
 # - Major version change = incompatible, must re-process

pyproject.toml

@@ -23,7 +23,7 @@ classifiers = [
     "Topic :: Text Processing :: Indexing",
 ]
 dependencies = [
-    "mcp[cli]>=1.0.0",
+    "mcp[cli]>=1.0.0,<2",
     "marker-pdf>=1.0.0",
     "chromadb>=0.4.0",
     "llama-index-core>=0.10.0",