Back to Home
junkreef icon

mcp-manual-walker

Verified Safe

by junkreef

Overview

Provides an MCP server for AI agents to efficiently access structured, token-efficient content from PDF manuals using bookmarks for navigation and semantic search.

Installation

Run Command
python src/mcp_manual_walker/main.py

Environment Variables

  • PDF_ROOT_DIR
  • DB_FILE_PATH
  • CHROMADB_PATH
  • MARKDOWN_OUTPUT_DIR
  • LOG_LEVEL
  • MAX_PAGES_PER_REQUEST
  • CHUNK_SIZE
  • CHUNK_OVERLAP
  • CHUNK_OVERLAP_SEARCH_MARGIN
  • HOST
  • PORT
  • DOCLING_NUM_THREADS
  • DOCLING_OCR_BATCH_SIZE
  • DOCLING_LAYOUT_BATCH_SIZE
  • DOCLING_TABLE_BATCH_SIZE

Security Notes

The server runs locally by default (127.0.0.1:8000) and processes PDF files from a predefined directory, reducing direct external attack surface. It uses SQLAlchemy for database interactions, mitigating SQL injection risks. File operations are constrained by `PDF_ROOT_DIR` to prevent path traversal. There are no obvious hardcoded secrets or 'eval' calls. The primary security consideration arises from the `docling` library's PDF processing, as vulnerabilities in this external dependency could be exploited if malicious PDFs are placed in the configured input directory. However, the `docling` processing is done via a separate `builder` script, not directly by the live server exposed to AI agents.

Similar Servers

Stats

Interest Score0
Security Score8
Cost ClassMedium
Avg Tokens5000
Stars0
Forks0
Last Update2026-01-11

Tags

PDFAI AgentManualsKnowledge BaseSemantic Search