CHM Converter

v1.0.0β€’File Systemsβ€’stable

chm to markdown and vectorDB

chmchm-markdownchm-to-markdownchm-vectordbdocument
Share:
70
Stars
0
Downloads
0
Weekly
0/5

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

Convert CHM documentation files to markdown format.
Build vector databases from CHM file content.
Transform legacy help files into searchable knowledge bases.
DTDucas

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx chm-converter

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

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
1

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.txt
2

Install 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 --help
3

Place 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/
4

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.py
5

Review 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.md

CHM 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 8

Troubleshooting 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.

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.

Quick Config Preview

{ "mcpServers": { "chm-converter": { "command": "npx", "args": ["-y", "chm-converter"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide β†’

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.

33,000+ ServersFree & Open SourceStep-by-Step Guides