Bug fix
Fixes the setup wizard (endnote-mcp setup) appearing to freeze at Step 2: PDF Attachments Directory — pressing Enter did nothing while typed characters kept echoing.
Root cause: it wasn't an input bug — the wizard was blocked, not waiting. To auto-detect the PDF folder it recursively globbed the whole of ~/Library (and other cloud-backed trees) for .enlp/.enl files. On a fresh Mac with iCloud Drive still syncing, that scan stalls on dataless placeholder files it has to fetch over the network. Because the process was busy and not reading stdin, the terminal just echoed keystrokes and ignored Enter — so the step looked frozen.
Fix:
- The library scan now uses a bounded
os.walkthat prunes~/Library,CloudStorage,Caches,Containersand package directories, limits recursion depth, and enforces an 8-second wall-clock budget — it can never hang; worst case it falls back to asking for the path manually. - The PDF directory is resolved by direct path (
<lib>.Data/PDF) instead of walking thousands of PDFs. - The picker's PDF count is now accurate — EndNote nests PDFs in per-record subfolders, so the old non-recursive count always showed
0. - A
Scanning…line makes the step's progress visible.
Also: the source distribution no longer bundles dev/runtime files (the mcp-publisher binary and the runtime database WAL), shrinking it from ~12 MB to ~49 KB.
Reported by: @WillVenters on a new MacBook (#4) — thanks!
Install / upgrade
uv tool install --upgrade endnote-mcp
# or
pipx upgrade endnote-mcp