CHM Converter
chm to markdown and vectorDB
What is CHM Converter?
CHM Converter is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to chm to markdown and vectordb
chm to markdown and vectorDB
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- chm to markdown and vectorDB
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx chm-converterConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use CHM Converter
CHM Converter MCP Server converts legacy Windows CHM (Compiled HTML Help) documentation files into Markdown format and optionally indexes the extracted content into a vector database for AI-powered search. It supports both single-file conversion and batch processing of entire directories, with specialized profiles for generic documentation and Autodesk Revit help files. This makes old CHM-format technical documentation searchable and usable by modern AI tools and knowledge management workflows.
Prerequisites
- Python 3.10 or higher with pip installed
- 7-Zip command-line tool installed: on macOS run 'brew install p7zip', on Linux run 'sudo apt install p7zip-full', on Windows install from 7-zip.org
- CHM files you want to convert, placed in the resources/ directory
- An MCP-compatible client if running as an MCP server
Clone the repository and install dependencies
Clone the CHM Converter repository and install all Python dependencies.
git clone https://github.com/DTDucas/chm-converter.git
cd chm-converter
pip install -r requirements.txtInstall 7-Zip for CHM extraction
The converter uses 7-Zip to unpack CHM archives. Install it for your operating system.
# macOS:
brew install p7zip
# Ubuntu/Debian:
sudo apt install p7zip-full
# Verify installation:
7z --helpPlace CHM files in the resources directory
Copy the CHM files you want to convert into the resources/ folder at the project root, or specify the full path with --single for individual files.
mkdir -p resources
cp /path/to/your/documentation.chm resources/Run conversion in interactive mode or via CLI
Convert a single file with the Revit profile, or batch-convert all files in resources/ with tuned concurrency settings.
# Single file conversion:
python chm_to_markdown.py --single resources/docs.chm --profile generic
# Batch convert all CHM files with custom concurrency:
python chm_to_markdown.py --all --workers 4 --batch-size 25
# Interactive mode (prompts for options):
python chm_to_markdown.pyReview the generated Markdown output
Converted files are written to the output directory along with index files. The file_index.json, id_lookup.json, and index.md files provide a navigable table of contents for the extracted content.
ls -la output/
cat output/index.mdCHM Converter Examples
Client configuration
Claude Desktop configuration for running CHM Converter as an MCP server using Python directly.
{
"mcpServers": {
"chm-converter": {
"command": "python",
"args": ["/path/to/chm-converter/chm_to_markdown.py"],
"cwd": "/path/to/chm-converter"
}
}
}Prompts to try
Example prompts and CLI commands for converting CHM documentation.
- "Convert my Revit 2024 help file to Markdown using the revit profile"
- Run: python chm_to_markdown.py --single resources/revit2024.chm --profile revit
- "Batch convert all CHM files in resources/ and preserve the original folder structure"
- Run: python chm_to_markdown.py --all --preserve-structure --workers 8Troubleshooting CHM Converter
Conversion fails with '7z command not found'
Install 7-Zip for your OS (brew install p7zip on macOS, sudo apt install p7zip-full on Linux). The tool must be accessible as 7z, 7za, or 7zz in your PATH. On Windows, add C:\Program Files\7-Zip\ to your system PATH.
Output Markdown has broken links or missing images
Run with the --keep-html flag to retain the extracted HTML files alongside Markdown. Images embedded in the CHM are extracted to the output directory and referenced from the HTML files.
Batch conversion is slow on large CHM files
Increase the worker count with --workers (default 8) and batch size with --batch-size (default 50). For very large CHM files, also increase --semaphore to allow more concurrent I/O operations.
Frequently Asked Questions about CHM Converter
What is CHM Converter?
CHM Converter is a Model Context Protocol (MCP) server that chm to markdown and vectordb It connects AI assistants to external tools and data sources through a standardized interface.
How do I install CHM Converter?
Follow the installation instructions on the CHM Converter GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with CHM Converter?
CHM Converter works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is CHM Converter free to use?
Yes, CHM Converter is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
CHM Converter Alternatives β Similar File Systems Servers
Looking for alternatives to CHM Converter? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.
Electerm
β 14.1kπ»Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)
Plik
β 1.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
β 957An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.
macOS Automator
β 801A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.
PDF Reader
β 723Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.
Filesystem MCP Server
β 643Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
Browse More File Systems MCP Servers
Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up CHM Converter in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use CHM Converter?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.