Huoshui MCP Server

An MCP server that provides PDF translation service

Local serverstdioPython

What is the Huoshui MCP server?

An MCP server that provides PDF translation service. Exposed over MCP by the huoshui mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

An intelligent PDF translation assistant that specializes in academic papers with mathematical formulas. Built using the FastMCP framework and powered by PDFMathTranslate-next, it provides comprehensive translation capabilities with context-aware assistance.

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at huoshui-pdf-translator on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Its toolset

Everything the assistant can do here goes through one of these:

  • Installation — The Installation tool exposed by this server
  • translate_pdf — Translates PDF documents while preserving mathematical formulas and layout
  • pdf_get — The pdf_get tool exposed by this server
  • warm_up_translator — Downloads required assets and models. Run this first to avoid timeouts
  • check_translation_tool — The check_translation_tool tool exposed by this server

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the huoshui mcp server does with a few real requests.

When to reach for it

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Huoshui's toolset — Installation, translate_pdf, pdf_get and 2 more — is a fair guide to whether it matches your workflow. It is maintained by huoshuiai42; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
InstallationThe Installation tool exposed by this server.
translate_pdfTranslates PDF documents while preserving mathematical formulas and layout.
pdf_getThe pdf_get tool exposed by this server.
warm_up_translatorDownloads required assets and models. Run this first to avoid timeouts.
check_translation_toolThe check_translation_tool tool exposed by this server.

How to install the Huoshui MCP server

{
  "mcpServers": {
    "huoshui-pdf-translator": {
      "command": "uv",
      "args": ["tool", "run", "huoshui-pdf-translator"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Huoshui to Installation.
  • Use Huoshui to translate pdf.
  • Use Huoshui to pdf get.

Frequently asked questions

It connects Huoshui to MCP-compatible AI assistants such as Claude and Cursor, exposing 5 tools (Installation, translate_pdf, pdf_get, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Huoshui directly.