Huoshui MCP Server

An MCP server that provides document format conversion

Local serverstdioPython

What is the Huoshui MCP server?

An MCP server that provides document format conversion. The huoshui mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 9 defined tools rather than through you.

What it actually does

A secure MCP (Model Context Protocol) server for document format conversion within a specified working directory.

  • 🔒 Sandbox Security: All operations restricted to a configured working directory
  • 📄 Format Support: Convert between Markdown, DOCX, HTML, PDF, and TXT
  • 🚀 MCP Integration: Full MCP protocol support with prompts, resources, and tools
  • ⚙️ Flexible Configuration: CLI arguments, environment variables, or current directory
  • 🔍 Smart Detection: Intelligent file format detection by content analysis

Adding it to your client

The server ships on PyPI as huoshui-file-converter, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Its toolset

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

  • convert_document — Convert files between formats
  • detect_format — Intelligent format detection
  • Installation — This server is available in the Model Context Protocol Registry. Install it using your MCP client
  • Examples — The Examples tool exposed by this server
  • Tools — The Tools tool exposed by this server
  • Resources — The Resources tool exposed by this server
  • Prompts — The Prompts tool exposed by this server
  • Requirements — The Requirements tool exposed by this server
  • Testing — The Testing tool exposed by this server

Configuration

You will need one environment variable: HUOSHUI_WORKING_DIR. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Python 3.8+ - pypandoc - pandoc (system dependency) - LaTeX (for PDF conversion)

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.
  • With 9 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Huoshui.
  • 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

Among the file and storage access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Huoshui's toolset — convert_document, detect_format, Installation and 6 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.

This entry was verified against Huoshui's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
convert_documentConvert files between formats
detect_formatIntelligent format detection
InstallationThis server is available in the Model Context Protocol Registry. Install it using your MCP client.
ExamplesThe Examples tool exposed by this server.
ToolsThe Tools tool exposed by this server.
ResourcesThe Resources tool exposed by this server.
PromptsThe Prompts tool exposed by this server.
RequirementsThe Requirements tool exposed by this server.
TestingThe Testing tool exposed by this server.

How to install the Huoshui MCP server

{
  "mcpServers": {
    "huoshui-file-converter": {
      "command": "uvx",
      "args": ["huoshui-file-converter"],
      "env": {
        "HUOSHUI_WORKING_DIR": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Python 3.8+ - pypandoc - pandoc (system dependency) - LaTeX (for PDF conversion)
VariableDescriptionRequired
HUOSHUI_WORKING_DIRFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use Huoshui to convert document.
  • Use Huoshui to detect format.
  • Use Huoshui to Installation.

Frequently asked questions

It connects Huoshui to MCP-compatible AI assistants such as Claude and Cursor, exposing 9 tools (convert_document, detect_format, Installation, 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.