
Huoshui Pdf Converter
Converts PDFs to Markdown and vice versa using PyMuPDF for extraction and ReportLab for generation. Exposes pdf_to_markdown and markdown_to_pdf tools through MCP, with options for image extraction, page sizing, margins, and font configuration. The engine automatically detects CJK characters and switches between ReportLab, xhtml2pdf, and fpdf2 based on content complexity. Handles Unicode properly across platforms by finding system fonts like Arial Unicode, PingFang SC, or Noto Sans CJK. Reach for this when you need bidirectional PDF conversion with Claude, especially if you're working with Chinese, Japanese, or Korean documents where font handling matters.
- tools
- 4
- transport
- STDIO
- last updated
- Sep 11, 2025
Tools
4 toolsPublic tool metadata for what this MCP can expose to an agent.
pdf_to_markdownConvert PDF files to Markdown
Convert PDF files to Markdown
No parameter schema in public metadata yet.
markdown_to_pdfConvert Markdown files to PDF
Convert Markdown files to PDF
No parameter schema in public metadata yet.
list_supported_formats
No parameter schema in public metadata yet.
validate_fileValidate input files before conversion
Validate input files before conversion
No parameter schema in public metadata yet.
Sponsors
Readme
活水 PDF 转换器 (Huoshui PDF Converter)
A high-quality, cross-platform PDF ↔ Markdown converter implemented as an MCP (Model Context Protocol) server. Supports bidirectional conversion with full Unicode/CJK character support.
Features
Core Capabilities
- PDF → Markdown: Extract text and images with layout preservation
- Markdown → PDF: Generate beautiful PDFs with multiple rendering engines
- Unicode Support: Full support for Chinese, Japanese, Korean, and other Unicode characters
- Cross-Platform: Works on Windows, macOS, and Linux
- MCP Integration: Use with Claude Desktop or any MCP-compatible client
Technical Features
Details
- Repository
- github.com/huoshuiai42/huoshui-pdf-converter
- Category
- Documents & Knowledge
- Package
huoshui-pdf-converter- Transport
- STDIO
- Registry
- MCP registry, active