Log inSubmit server

Hidden while we check this listing

Our automated checks found a problem, so this listing is out of search, browse and the API until it clears. It comes back on its own once the problem is fixed.

  • No commits in a year, never verified, no traction
Own this project? Claim it
Huoshui Pdf Translator logo

Huoshui Pdf Translator

Translates academic and technical PDFs while preserving mathematical formulas, formatting, and document layout.

InstallRepository
Full README Compare alternatives Embed widget Claim this listing

Install Huoshui Pdf Translator

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "huoshui-pdf-translator": {
      "command": "uvx",
      "args": [
        "huoshui-pdf-translator"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The huoshui-pdf-translator MCP server translates PDF files with PDFMathTranslate-next while preserving mathematical formulas and page layout. It exposes translation, PDF inspection, translator warm-up, and status-checking tools through FastMCP. Chinese-English translation is a stated specialization, with automatic language detection and support for flexible file paths. Reach for it when an MCP client needs to translate academic papers or technical documents while retaining their structure.

Use cases

  • Translate academic papers with mathematical formulas
  • Convert technical PDFs between Chinese and English
  • Inspect PDF metadata before translation
  • Warm up translation assets before a long job

Key features

  • Preserves mathematical formulas and PDF layout
  • Supports Chinese-English translation
  • Accepts absolute and home-relative file paths
  • Reports PDF metadata and translation-tool status
  • Provides warm-up downloads for fonts and models
  • Includes progress reporting and error diagnosis

Tools1

What Huoshui Pdf Translator lets your agent do. Expand a tool for its parameters.

Self-reported~22 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · huoshui-pdf-translator (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
Last commit1y agoMost recent push to the default branch.
Tools exposed1Callable tools this server registers over MCP.

How Huoshui Pdf Translator works

What huoshui-pdf-translator does

The huoshui-pdf-translator MCP server translates academic papers and technical PDFs while retaining mathematical expressions, formatting, and the original document structure. It is built with FastMCP and uses PDFMathTranslate-next as its translation engine.

The main translation result can include two output files: a dual-language version and a Chinese-only version. The translation tool accepts an input PDF path and can write to a caller-specified output path. A 200 MB maximum file size is documented.

How it works

Install the package as an MCP server, then invoke its tools from a compatible client. On first use, run the warm-up operation so the server can download required fonts and models. The README estimates this cache at about 50 MB. Initial translation may take two to five minutes because of setup downloads; later translations are listed at roughly 30 to 60 seconds.

The server accepts absolute paths, paths relative to the user’s home directory, and simple filenames interpreted from the home directory. It validates paths and includes protection for system directories. Translation progress and diagnostic messages are available through the assistant workflow.

Setup and configuration

The huoshui-pdf-translator MCP server can be installed with uvx huoshui-pdf-translator, through pipx, or as a UV tool. The documented Claude Desktop configuration starts the server with uvx and the package name. Source installation is also available with uv sync, followed by uv run python -m huoshui_pdf_translator.main.

After installation, warm up the translator, check its status, and then submit a PDF for translation. The status check verifies whether PDFMathTranslate-next is installed and available. Internet access is required for initial font downloads.

Tools and capabilities

  • translate_pdf translates a PDF and supports a custom output path.
  • pdf_get returns PDF metadata including path, byte size, and page count.
  • warm_up_translator downloads fonts and models before translation.
  • check_translation_tool reports the translation dependency’s status, version, and message.
  • Prompts cover path guidance, translation options, role and operating rules, error troubleshooting, and result explanation.
  • Resources provide translation capability listings and PDF file information.

Limitations and notes

The huoshui-pdf-translator MCP server documents a 200 MB file limit. The first run may be slow or time out if the required assets have not been downloaded, so warming up first is recommended. Network connectivity and suitable firewall access are needed for those downloads. Missing files, invalid PDFs, dependency problems, and path errors require correction before translation can proceed.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Huoshui Pdf Translator

huoshui-pdf-translator is an MCP server that connects MCP clients to PDFMathTranslate-next for translating academic and technical PDF files. Its main tools translate PDFs, inspect file metadata, warm up fonts and models, and check translation-tool status. It focuses on preserving mathematical formulas, formatting, and document layout.

Install it with `uvx huoshui-pdf-translator`, or use pipx or UV tools. For Claude Desktop, add an MCP entry that runs `uvx` with `huoshui-pdf-translator` as its argument. Source installation is also documented with `uv sync`.

Run `warm_up_translator` before translating. It downloads the fonts and models needed by the translation engine, which avoids making the first translation perform that setup work. The initial download is about 50 MB and requires internet access.

It does not state whether Cursor is supported or unsupported. The server is launched as a standard package command with `uvx`, but client-specific setup should be verified separately.

Related MCP servers

All in Translation Services All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewHuoshui Pdf Translator AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/huoshui-pdf-translator?style=directory)](https://allmcps.com/mcp/huoshui-pdf-translator)
HTML Embed
<a href="https://allmcps.com/mcp/huoshui-pdf-translator"><img src="https://allmcps.com/api/badge/huoshui-pdf-translator?style=directory" alt="Huoshui Pdf Translator on AllMCPs" /></a>