anymd
SylphxAI · SylphxAI/anymd
MCP server Rust cục bộ, nhanh chóng này và CLI chuyển đổi nhiều loại tệp, bao gồm PDF, Word, HTML và âm thanh/video, thành Markdown sạch cho các agent AI sử dụng mà không cần API key.
Bất kỳ tệp nào → Markdown sạch cho các AI agent: PDF, Word, PowerPoint, Excel, EPUB, HTML và các trang web, hình ảnh (OCR), âm thanh và video (siêu dữ liệu, phụ đề, bản ghi). Một MCP server và CLI Rust nhanh chóng chạy trên máy của bạn. Không cần API key.
Xem kết quả thực tế
Ảnh từ README của tác giả SylphxAI ·Nguồn
Bạn có thể làm gì với nó
- Chuyển đổi các báo cáo PDF phức tạp thành Markdown dễ đọc để agent AI phân tích.
- Trích xuất văn bản và siêu dữ liệu từ tài liệu Word, bảng Excel hoặc sách EPUB để xử lý bằng AI.
- Tạo bản ghi và phụ đề từ các tệp âm thanh/video để cung cấp ngữ cảnh cho agent AI.
Kiểm tra an toàn
Không thấy dấu hiệu rủi ro trong các file đã quét.
Quét tự động các file trong repo. Luôn xem lại code trước khi chạy.
Trích từ README
anymd
PDF, Word, PowerPoint, Excel, EPUB, HTML and web pages, images (OCR), audio and video (metadata, subtitles, transcripts). A fast Rust MCP server and CLI that runs on your machine. No API key.
Install · Benchmarks · Tools · CLI · Formats · Docs · Pro
Formerly pdf-reader-mcp. Migrating from pdf-reader-mcp
A real, unedited terminal recording (asciinema + agg, script). The last command is Claude Code answering from the PDF through the anymd MCP server.
npx -y @sylphx/anymd setup # add anymd to every MCP client on this machine
npx -y @sylphx/anymd report.pdf > report.md # or convert from the shell
Why anymd
-
Fast. Native Rust converts in parallel, page by page. On the 38 benchmark documents, anymd takes 11.5 s in total; docling 2,432.4 s (212×), markitdown 75.6 s (7×); marker converted 30 of them in 7,104.5 s, against anymd's 4.64 s on the same 30 (1,532×).
-
Accurate. A layout engine rebuilds words from glyph gaps, puts two-column papers in reading order, and recovers tables, including borderless ones. The text stays exactly as printed, with no glued words and no scrambled columns.
-
Lean on tokens. Pages come back as Markdown with `` citation anchors, a small front-matter header, and compact tables. A token budget and a cursor keep large documents within your agent's context.
-
Every format, one call. One tool reads every format listed below. It also accepts web URLs and whole directories, and
searchlooks across all of them. -
Local and private. Nothing is uploaded. OCR uses installed local doc-VLM models or tesseract; transcripts use ffmpeg and bundled Qwen3-ASR. OCR setup and ASR model downloads require explicit opt-in.
Install
Add anymd to every MCP client on your machine (Claude Code, Codex, Cursor, VS Code, Claude Desktop, Windsurf, Gemini CLI) with one command:
npx -y @sylphx/anymd setup # --dry-run to preview, --remove to undo
Or add it by hand: every MCP client runs the same command, npx -y @sylphx/anymd. Node 18+ is the only requirement; npm installs the native binary for your platform.
Claude Code
claude mcp add anymd -- npx -y @sylphx/anymd
Or as a plugin, with the anymd skill: /plugin marketplace add SylphxAI/anymd, then /plugin install anymd@anymd.
Codex
codex mcp add anymd -- npx -y @sylphx/anymd
or in ~/.codex/config.toml:
[mcp_servers.anymd]
command = "npx"
args = ["-y", "@sylphx/anymd"]
Cursor
or in .cursor/mcp.json:
{ "mcpServers": { "anymd": { "command": "npx", "args": ["-y", "@sylphx/anymd"] } } }
VS Code
Install in VS Code with one click, or from a terminal:
code --add-mcp '{"name":"anymd","command":"npx","args":["-y","@sylphx/anymd"]}'
or in .vscode/mcp.json:
{ "servers": { "anymd": { "type": "stdio", "command": "npx", "args": ["-y", "@sylphx/anymd"] } } }
Claude Desktop
One click: download anymd-<version>.mcpb from the latest release and open it. Or, by hand:
Add to claude_desktop_config.json (Settings → Developer → Edit Config):
{ "mcpServers": { "anymd": { "command": "npx", "args": ["-y", "@sylphx/anymd"] } } }
Windsurf, Zed, Cline, and other clients
Any client that speaks MCP over stdio: command npx, args ["-y", "@sylphx/anymd"]. To keep the server inside one folder, add --allow-dir=/path/to/docs.
CLI only
npm install -g @sylphx/anymd # or run it once with: npx -y @sylphx/anymd <file>
Python: uvx anymd report.pdf > report.md runs it once, pip install anymd installs it, and uvx anymd mcp starts the MCP server. The wheels carry the same prebuilt binary.
Docker (amd64 and arm64):
docker run --rm -v "$PWD:/data" ghcr.io/sylphxai/anymd report.pdf > report.md
docker run -i --rm ghcr.io/sylphxai/anymd # MCP server on stdio
Or build it from crates.io (Rust 1.95+, CMake and a C++ compiler; doc-VLM OCR and local ASR are included):
cargo install anymd
npm, pip and Docker ship a prebuilt binary, while cargo install compiles one on your machine.
Benchmarks
AgentDocBench is an open benchmark for document → Markdown conversion for agents: license-clean documents in 12 categories (math papers, two-column papers, financial tables, forms, scans, CJK, slides, spreadsheets, Word, EPUB, HTML), scored on verbatim sentences, text F1, reading order, and table cells, with time and output tokens. Every tool runs on the same kind of GitHub-hosted runner (4 CPUs):
| anymd | docling | kreuzberg | unstructured | markitdown | marker | pdftotext | |
|---|---|---|---|---|---|---|---|
| Overall score | 96.4 | 93.0 | 81.7 | 81.2 | 76.8 | 71.0 | 42.2 |
| Table cells F1 | 92.2 | 89.9 | 38.4 | 38.4 | 57.2 | 60.9 | 0.0 |
| Reading order | 98.8 | 94.4 | 96.8 | 93.9 | 85.5 | 76.8 | 52.0 |
| Docs converted | 38/38 | 38/38 | 38/38 | 38/38 | 38/38 | 30/38 | 23/38 |
| Time, all docs | 11.5 s | 2,432.4 s | 16.0 s | 346.5 s | 75.6 s | 7,104.5 s | 0.90 s |
The generated leaderboard, per-category scores (including where anymd loses), and method are in the benchmark guide. The corpus, ground truth, adapters, and raw results are in bench/, and the [Benchmark workflow](https://github.com/SylphxAI/anymd/blob/ma
