Huoshui File Converter — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Huoshui File Converter (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
A secure MCP (Model Context Protocol) server for document format conversion within a specified working directory.
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-converterOption 3: Using pip
pip install huoshui-file-converter# 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"For Claude Desktop or other MCP clients:
{
"mcpServers": {
"huoshui-converter": {
"command": "uvx",
"args": ["huoshui-file-converter", "--dir", "/Users/yourname/Documents"]
}
}
}--dir or -dHUOSHUI_WORKING_DIR# CLI argument (best for MCP clients)
uvx huoshui-file-converter --dir "/project/docs"
# Environment variable
export HUOSHUI_WORKING_DIR="/project/docs"
uvx huoshui-file-converter
# Current directory fallback
cd /project/docs
uvx huoshui-file-converter| From | To |
|---|---|
| Markdown | DOCX, HTML, PDF |
| DOCX | Markdown, HTML, PDF |
| HTML | Markdown, DOCX, PDF |
| TXT | Markdown, DOCX, HTML, PDF |
convert_document: Convert files between formatsdetect_format: Intelligent format detectionfile_list: Browse directory contents (optimized for large directories)limit: Control number of files shown (default: 100)supported_only: Show only convertible filesfile_get: Get detailed file informationconversion_capability_list: List supported conversionsrole_and_rules: AI assistant behavior guidelines$ uvx huoshui-file-converter --help
usage: huoshui-file-converter [-h] [--dir PATH] [--version]
Huoshui Document Converter - MCP Server for file conversion within a working directory
options:
-h, --help show this help message and exit
--dir PATH, -d PATH
Working directory for file operations (default: current directory or HUOSHUI_WORKING_DIR env var)
--version, -v show program's version number and exit
Examples:
uvx huoshui-file-converter # Use current directory
uvx huoshui-file-converter --dir /docs # Use specific directory
uvx huoshui-file-converter -d ./project # Use relative directory
Configuration Priority:
1. CLI argument (--dir/-d)
2. Environment variable (HUOSHUI_WORKING_DIR)
3. Current working directoryThe server validates the working directory on startup:
✅ Working directory configured: /Users/name/Documents
📂 Source: CLI argumentCommon errors and solutions:
| Error | Solution |
|---|---|
| Directory not found | Create directory or fix path |
| No write access | Check permissions (chmod on Unix) |
| Path outside sandbox | Use relative paths only |
# Test configuration
uvx huoshui-file-converter --dir "/tmp/test"
# Check startup messages
# ✅ Working directory configured: /tmp/test
# 📂 Source: CLI argument[Your license here]
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.