This release includes 1 breaking change for platform teams planning a safe upgrade.
Published 1mo
MCP Developer Tools
✓ No known CVEs patched
✓ No known CVEs patched in this version
Topics
ai
anthropic
anthropic-ai
anthropic-claude
markdown
mcp
+3 more
model-context-protocol
ocr
tools
Summary
AI summaryprojectRoot removed from the MCP tool input schema.
Full changelog
Path-resolution overhaul to make Docker (and any non-default install layout) frictionless. Closes #97 via #98.
What's new
MARKITDOWN_PATHenv var. Defaults to<project>/.venv/bin/markitdown, falls back to a bare-namePATHlookup. Letspipx install "markitdown[pdf]"or any system install work without a project venv.REPOMIX_PATHenv var. Same shape, forgit-repo-to-markdown.MD_ALLOWED_PATHSenv var (path-delimiter-separated). Enforced on every filepath-accepting tool, not justget-markdown-file.MD_SHARE_DIRkept as a single-dir backward-compat alias.- Docker volume-mount example in the README, aligned with the
markdownify.pathsfield on the Docker MCP catalog config page. - New
scripts/docker-smoke-test.sh: builds the image, mounts a sample dir, callspdf-to-markdownover the MCP stdio transport, asserts the response.
Fixes
- Stop treating non-empty stderr from
markitdownas fatal — it emits non-fatal warnings on every successful run (onnxruntime cpuid, pydub ffmpeg-missing). Exit code is the real signal. - Add
.dockerignoresoCOPY . .no longer drags the host's.venvandnode_modulesinto the build context. - Replace stale
UV_PATHdocs (the code stopped usinguvseveral versions ago).
Breaking changes
projectRootremoved from the MCP tool input schema. It was client-controllable, so any MCP client could force the server to exec<arbitrary>/.venv/bin/markitdown. No legitimate client should have been using it. If you need to override the project root, setMARKITDOWN_PATHdirectly.
Breaking Changes
- `projectRoot` removed from the MCP tool input schema. Use `MARKITDOWN_PATH` to override the project root.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About Markdownify MCP
All releases →Related context
Beta — feedback welcome: [email protected]