Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)
Answer questions from PDFs converted to .htpd: exact text with pages, or 'Not found in this file.'
สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน
ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ต้องเตรียมก่อน
คุณใช้แอปไหน
เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”
เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json
{
"mcpServers": {
"htpd": {
"command": "uvx",
"args": [
"htpd-reader"
]
}
}
}พิมพ์คำสั่งนี้ใน Terminal
claude mcp add htpd -- uvx htpd-readerวางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"htpd": {
"command": "uvx",
"args": [
"htpd-reader"
]
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"htpd": {
"type": "stdio",
"command": "uvx",
"args": [
"htpd-reader"
]
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น
ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 9 พ.ย. 2569
ชื่อใน registry ยืนยันด้วยบัญชี GitHub narendrachampaneri ซึ่งเป็นเจ้าของ repo
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.1.2.post1) เข้า registry 17 วันที่ผ่านมา
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย
ในหมวดเดียวกันมี Spec Driven Development, Remote Desktop Commander, Shield Kya
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
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.
Audit trail and traceability for AI agents. MCP gate: evaluate, ingest, request approval.
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
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
ตัดมาแค่ช่วงต้น อ่านต่อใน repo