Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Beschreibung vom Entwickler (englisches Original)
Answer questions from PDFs converted to .htpd: exact text with pages, or 'Not found in this file.'
Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.
Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Du brauchst
Welche App nutzt du?
Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.
Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein
{
"mcpServers": {
"htpd": {
"command": "uvx",
"args": [
"htpd-reader"
]
}
}
}Führe das in deinem Terminal aus
claude mcp add htpd -- uvx htpd-readerIn .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen
{
"mcpServers": {
"htpd": {
"command": "uvx",
"args": [
"htpd-reader"
]
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
In .vscode/mcp.json in deinem Projekt einfügen
{
"servers": {
"htpd": {
"type": "stdio",
"command": "uvx",
"args": [
"htpd-reader"
]
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.
Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 10. Nov. 2026
Der Registry-Name wurde mit dem GitHub-Konto narendrachampaneri bestätigt, dem das Repo gehört
Dieses Repo haben wir noch nicht von GitHub gelesen
Dieses Repo haben wir noch nicht von GitHub gelesen
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.1.2.post1) kam vor 17 Tagen in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.
In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, Backup Radar MCP
Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Every Backup Radar v3 and v2 endpoint plus a local store that finds the backups nobody is watching.
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
Turn long PDFs into documents AI reads correctly - exact text, every answer with its page.
In plain words · See it work · Install · Use with your AI · For developers · Quality
You have a long PDF - a 300-page datasheet, a 5000-page reference manual, a policy, a report - and a question about it. Given the whole PDF, an AI often answers slowly, misses details, mixes up tables and cannot show where its answer comes from.
HTPD prepares the document for the AI. The converter turns the PDF into one .htpd file: the same text, word for word, cut into the document's own chapters and sections, with the page of every paragraph, the tables as rows, and the figures as pictures. The AI then reads only the few sections a question needs and answers from the exact text - with the page, so you can check it.
| What you get | What it means for you |
|---|---|
| Exact text | Values, part numbers and register names exactly as in the PDF. Nothing is summarised or rewritten. |
| A page for every fact | Every answer can be checked in the original document in seconds. |
| Honest answers | When the document does not hold the answer, HTPD says so instead of guessing. |
| Tables and figures | Tables stay rows with their columns; diagrams and photos are kept as pictures with their caption. |
| Scanned pages too | Text in scans and pictures is read by OCR (free Tesseract), marked so you know. |
| Private and free | Runs on your own computer. No GPU, no account, no cloud. Open source. |
Try it in the browser: HTPD Studio.
Real commands and their output on a public 109-page data sheet (NXP i.MX 93, shortened where long).
1. Convert the PDF once - about a second for 100 pages:
2. Ask in your own words - the exact line from the document, with its page and section:
3. Figures stay pictures - an AI that can see images looks at the diagram itself:
In daily use you do not type these commands: you give the .htpd file to your AI, or let the plugin, the skill or the MCP server do it for you.
| You use | Do this |
|---|---|
| Claude Code | /plugin marketplace add narendrachampaneri/htpd then /plugin install htpd@htpd - converts PDFs and answers from them; the MCP server is included |
| Claude app and other apps with skills | Add htpd-skill.zip under *Customize → Skills* |
| Any MCP client (Antigravity, Codex, Cursor, ...) | pip install htpd-reader, then the command htpd-mcp --bundles - or find io.github.narendrachampaneri/htpd in the MCP registry |
| ChatGPT, Gemini | Upload the .htpd file, or make a custom GPT / Gem with the ready instructions |
The converter (PDF → .htpd) | Download htpd-0.1.2-linux-x64.tar.gz (Linux, Windows with WSL) and run ./htpd convert manual.pdf --single |
The converter and the reader run on your computer. What reaches an AI is only the text you give it.
Any AI chat - just upload the file
htpd convert manual.pdf --single writes one `.htpd` file. It begins with the reading rules for the model - *answer only from this file, give the page of every fact, say so when the answer is not there* - then the contents and every section with its pages.
Upload it to Claude, ChatGPT, Gemini or any other assistant instead of the PDF. If an app does not accept the extension, rename it to manual.htpd.txt - it is plain text. For a ChatGPT custom GPT or a Gemini Gem that always has your document, see docs/AI-APPS.md (instructions ready to paste).
Best for documents that fit in the chat (a datasheet of a few hundred pages). For very large manuals use the skill, the plugin or MCP below.
Claude app and apps with skills - the htpd skill
| App | How to add it |
|---|---|
| Claude app | *Customize → Skills*, upload htpd-skill.zip, switch it on (code execution must be on). Then upload a .htpd file to a chat and ask. |
| Claude Code | Install the plugin (below), or unzip into ~/.claude/skills/. |
Other agents that read SKILL.md | Unzip into their skills folder. |
The skill runs a small script that needs only Python - no packages, no model. It finds the right sections and returns the exact lines with [page, section]. Because the AI reads only what the script returns, this works even for manuals of thousands of pages.
Claude Code - the htpd plugin
/plugin marketplace add narendrachampaneri/htpd
/plugin install htpd@htpd
Then ask in plain words - *"convert datasheet.pdf to htpd"*, *"what is the maximum NPU frequency in datasheet.htpd?"* - or run /htpd:convert datasheet.pdf --single. The first conversion downloads the released converter once (Linux and WSL, about 4 MB, checked by SHA-256). The PDF never leaves the computer.
Agents with MCP - the htpd-mcp server
pip install htpd-reader # htpd-read and htpd-mcp, nothing else needed
claude mcp add htpd -- htpd-mcp --bundles ~/manuals # Claude Code
For Antigravity, Codex, Cursor or any MCP client: command htpd-mcp, arguments --bundles /path/to/your/htpd/files. The server is also listed in the official MCP registry as io.github.narendrachampaneri/htpd (clients start it with uvx htpd-reader). Tools: list_bundles, contents, open_section, search, ask, figure (the picture of a figure, as an image), check.
flowchart LR
PDF["📄 PDF scanned or digital"] -->|htpd convert| H["HTPD sections · pages · tables · figures"] H -->|upload| CHAT["AI chat (file + reading rules)"] H -->|skill · plugin · MCP| AGENT["AI agent (Claude, Antigravity, Codex)"] CHAT --> ANS["Answer from the exact text with page numbers"] AGENT --> ANS
| Part | What it does |
|---|---|
Converter htpd (C++23, PDFium) | Reads every character with its position and font, removes headers and footers, finds the headings (bookmarks, the PDF's own tags, a printed table of contents, numbering, font size), cuts the text into sections, reads tables as rows (from the lines the page draws, the PDF's tags or the text; cells over columns or rows are marked) and keeps code as code, stores figures as PNG with their caption, reads scans with OCR. |
Reader htpd-read (Python, standard library only) | Finds the sections that answer a question (word search, the tree of titles, a small trained re-ranker), packs only that text with its pages, picks the exact answer lines, and says when the file cannot answer. Also as a skill, a plugin and an MCP server. |
Download (no build needed) from the release page:
tar xzf htpd-0.1.2-linux-x64.tar.gz
cd htpd-0.1.2-linux-x64 ./htpd convert manual.pdf --single # writes manual.htpd sudo apt install tesseract-ocr # optional: read scanned pages too
Build from source - Linux (Ubuntu 24.04, also WSL), g++ 13+, make or CMake, Python 3.10+:
git clone https://github.com/narendrachampaneri/htpd.git && cd htpd
./scripts/get_pdfium.sh # the PDF engine, once (about 4 MB) make # builds build/htpd make test # the C++ tests
Convert and ask:
./build/htpd convert manual.pdf --single # one file: manual.htpd (for AI chats)
./build/htpd convert manual.pdf # a folder: manual.htpd/ (for tools and agents)
pip install htpd-reader # or: python3 -m pip install -e . htpd-read ask examples/single-file/sample.htpd "What is the maximum bus voltage?"
[page 2, 2.1.1 Limits] Parameter | Min | Typ | Max | Unit Bus voltage | 200 | 400 | 480 | V
Every answer line is copied word for word from the file; --context adds the whole sections for the AI. More commands: contents, section, search, figure, check - see [reader/README.md](https://github.com/narendrachampaneri/htpd/blob/ma
Nur der Anfang wird gezeigt; den Rest findest du im Repo