huoshuiai42 avatar

Huoshui Pdf Converter

huoshuiai42/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 tools

Public 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)

License: MIT Python 3.10+ MCP PyPI version

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


View the full README on GitHub

Details

Repository
github.com/huoshuiai42/huoshui-pdf-converter
Category
Documents & Knowledge
Package
huoshui-pdf-converter
Transport
STDIO
Registry
MCP registry, active

More from huoshuiai42

Related Documents & Knowledge MCP servers

View all
1infoinlet-marketplace avatarMcp Notioninfoinlet-marketplace/marketplaceNotion for AI agents — search, read pages/blocks, query databases, create pages.0stars
2pipeworx-io avatarConfluencepipeworx-io/mcp-confluenceConfluence MCP — wraps the Confluence Cloud REST API v2 (OAuth)0stars
3kimsb2429 avatarEnterprise Internal Knowledge Base: Production-Ready RAG + MCPkimsb2429/internal-knowledge-baseProduction-ready RAG + MCP demo: eval-in-CI merge gate, Langfuse traces, structure-aware chunking.0stars
4mifactory-bot avatarMifactory Pdfmifactory-bot/mifactory-pdfSend transactional pdfs for AI agents via SMTP. Templates included.0stars
5shaneholloman avatarMCP Knowledge Graphshaneholloman/mcp-knowledge-graphProvides a local knowledge graph memory store for AI models with master and named databases accessible via MCP tools.857stars
6domdomegg avatarAirtabledomdomegg/airtable-mcp-serverRead and write access to Airtable database schemas, tables, and records.456stars