Qt4 Doc MCP server

Qt Documentation MCP Server

mcp-name: io.github.jztan/qt4-doc-mcp-server

Bring locally installed Qt 4.8, Qt 5, or Qt 6 documentation to your AI coding assistant. Works offline with one selected documentation set at a time.

Tool Reference | Changelog | Contributing | Troubleshooting

✨ Features

• 🔌 Offline-First - Works entirely with local documentation
• 🔍 Full-Text Search - Find what you need across all Qt docs
• ⚡ Smart Caching - Fast responses for repeated queries
• 🎯 Fragment Support - Extract specific sections when needed
• 🛠️ MCP Standard - Compatible with Claude, VS Code, and other MCP clients

📦 Prerequisites

• Python 3.11+ required (not needed when using the Docker image)
• Qt HTML Documentation for one supported release (Qt 4.8, Qt 5, or Qt 6)
• The included helper downloads Qt 4.8.4 only.
• Point QTDOCBASE directly at an existing Qt 5/6 offline documentation root.
• ~500MB disk space for docs + cache + search index
• SQLite with FTS5 support (included in Python 3.11+ by default)

🚀 Installation

From PyPI (Recommended)

pip install qt4-doc-mcp-server

From Source

git clone https://github.com/jztan/qt4-doc-mcp-server.git
cd qt4-doc-mcp-server
uv sync --locked

Setup Qt Documentation

# Automated setup (recommended, requires the cloned repo)
python scripts/prepare_qt48_docs.py --segments 4

# This will:
# - Download Qt 4.8.4 source archive
# - Extract HTML documentation
# - Create .env with sensible defaults
# - Copy GFDL license file

The helper script ships with the repo, not the PyPI package. Installed from PyPI only? Download the docs manually instead:

curl -LO https://download.qt.io/archive/qt/4.8/4.8.4/qt-everywhere-opensource-src-4.8.4.tar.gz
tar -xzf qt-everywhere-opensource-src-4.8.4.tar.gz qt-everywhere-opensource-src-4.8.4/doc/html
mv qt-everywhere-opensource-src-4.8.4/doc/html ./qt4-docs-html

Then create a .env with QTDOCBASE pointing at that directory (see Configuration below).

Quick Start Commands

# 1. Install
pip install qt4-doc-mcp-server

# 2. Setup Qt docs
python scripts/prepare_qt48_docs.py --segments 4

# 3. Build search index (optional; the server builds it on first start)
qt-doc-build-index

# 4. Start server
qt-doc-mcp

# 5. Verify health
curl -s http://127.0.0.1:8000/health

The legacy qt4-doc-mcp-server command remains available as an alias for existing client configurations.

Agent-friendly FTS CLI

After building the index, agents can search and receive materialized absolute Markdown paths:

qt-doc-cli "accessible applications" --limit 5

The command reads the same .env settings as the server. Before searching, it automatically builds a missing/outdated FTS index and fully warms an incomplete Markdown cache. It then prints each result's title, absolute .md path, and FTS snippet to stdout; preparation messages, errors, and warnings go to stderr. Use qt-doc-warm-md --force after changing documentation in place.

🐳 Docker

Shortened. The full README is on GitHub.