Skip to content

v1.4.6 — Fix Unicode NFC/NFD filename mismatch on macOS

Choose a tag to compare

@gokmengokhan gokmengokhan released this 25 May 07:49
· 3 commits to main since this release

Bug fix

Fixes a silent indexing failure on macOS where any PDF whose filename contained a non-ASCII character (ü, ö, ş, ç, ı, é, ñ, Ğ, İ, etc.) was reported as "not found" despite existing on disk.

Root cause: macOS APFS stores filenames in NFD (decomposed Unicode), while EndNote's XML export uses NFC (precomposed). The _pdf_cache lookup compared strings byte-equal, so the two forms never matched.

Fix: _build_pdf_cache now indexes both raw and NFC-normalized forms, and find_pdf falls back to NFC normalization (including for URL-decoded variants).

Impact: Recovered 19 previously-unindexed PDFs (+457 pages) in the maintainer's library on first reindex.

Install / upgrade

uv tool install --upgrade endnote-mcp
# or
pipx upgrade endnote-mcp

Then run endnote-mcp index to pick up any non-ASCII PDFs that were previously skipped.