Huoshui File Converter
Gives Claude document conversion capabilities through pypandoc and Pandoc. Exposes convert_document and detect_format tools to handle Markdown, DOCX, HTML, PDF, and TXT files within a sandboxed working directory you configure at startup. Provides file_list and file_get resources for browsing convertible files, with smart defaults that limit directory listings to 100 files to avoid freezing on large folders. You set the working directory via CLI argument, environment variable, or let it default to your current location. All file operations are restricted to that sandbox with path validation. Reach for this when you need Claude to handle format conversions during document workflows without manual export steps.
- tools
- 2
- transport
- STDIO
- env var
- 1
- last updated
- Sep 11, 2025
Tools
2 toolsPublic tool metadata for what this MCP can expose to an agent.
convert_documentConvert files between formats
Convert files between formats
No parameter schema in public metadata yet.
detect_formatIntelligent format detection
Intelligent format detection
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
HUOSHUI_WORKING_DIRYour workding directory
Readme
Huoshui File Converter
A secure MCP (Model Context Protocol) server for document format conversion within a specified working directory.
Features
- 🔒 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
Quick Start
Installation
Option 1: From MCP Registry (Recommended)
This server is available in the Model Context Protocol Registry. Install it using your MCP client.
mcp-name: io.github.huoshuiai42/huoshui-file-converter
Option 2: Using uvx
uvx huoshui-file-converter
Option 3: Using pip
pip install huoshui-file-converter
Basic Usage
# Use current directory
uvx huoshui-file-converter
# Specify working directory (recommended)
uvx huoshui-file-converter --dir "/path/to/documents"
# Short form
uvx huoshui-file-converter -d "~/Documents"
Details
- Repository
- github.com/huoshuiai42/huoshui-file-converter
- Category
- Documents & Knowledge
- Package
huoshui-file-converter- Transport
- STDIO
- Registry
- MCP registry, active
More from huoshuiai42
Related Documents & Knowledge MCP servers
View all
DocDeploymrdulasolutions/docdeployDocument hosting and encrypted agent memory with multi-tenant persistence.0stars
Web Scraper to Markdown APIbr0ski777/web-scraper-x402Extract clean markdown from any URL. Removes boilerplate. For RAG pipelines. x402.0stars
Filesystemfieldcure/fieldcure-mcp-filesystemSecure MCP server for sandboxed filesystem operations with document parsing support.0stars
Wikimintgreenmtnsun/ps-wiki-centralGenerate wiki docs from source code. Supports PowerShell, Python, Go, C#, Java, COBOL.0stars
KatanA Markdown Linterhiroyukifuruno/katana-markdown-linterMarkdown linter, workspace-scoped stdio MCP server, and self-hosted text-only remote MCP server.0stars
PasteMDjini-tw/claude-plugin-pastemdInstant markdown sharing. Create, manage, and share documents with password protection.0stars