drolosoft/go-docs-mcp

> **Install and Go.** One command, single binary. Your AI reads any document — PDF, text, Markdown, DOCX, images.
MCP server for multi-format document access — read, search, extract images, OCR, and fetch documents from URLs via the Model Context Protocol. 13 tools, 6 formats, zero configuration.
For a deeper look at why an MCP server beats a direct tool, see **Why MCP?**
---
🏆 Why Go-Docs MCP?
Every other document MCP server handles **one format** — a PDF server for PDFs, a DOCX server for DOCX. You'd need three separate servers to read three formats.
| | Go-Docs MCP | Others |
|--|:---:|:---:|
| Single binary, no runtime | **Yes** | Need Node/Python |
| go install one-liner | **Yes** | npm+deps or pip+venv |
| Multi-format (6 types) | **Yes** | One format each |
| Full-text search | **Yes** | Partial or none |
| OCR (scanned PDFs + images) | **Yes** | Rare |
| Image & table extraction | **Yes** | Partial |
| Document outline | **Yes** | Rare |
| Fetch from URL | **Yes** | Rare |
| Dir-locked, read-only | **Yes** | Varies |
| Smart caching | **Yes** | No |
| Fully offline | **Yes** | Yes |
Go-Docs MCP reads them all from a single binary — fast, secure, and dependency-free at runtime.
---
📋 Features — 13 Tools
| Category | Tool | Description |
|----------|------|-------------|
| **Discovery** | list_documents | List all documents with metadata (format, pages, size) |
| **Discovery** | list_formats | List supported formats and dependency status |
| **Reading** | read_document | Full text, specific page, or page ranges from any format |
| **Reading** | read_url | Download from URL and extract text (50MB max) |
| **Reading** | get_document_summary | First 3 pages as a quick overview |
| **Search** | search_document | Case-insensitive full-text search with context |
| **Analysis** | get_document_metadata | Title, author, dates, version, page count |
| **Analysis** | get_document_outline | Table of contents / bookmarks |
| **Analysis** | extract_tables | Tables as structured data |
| **Analysis** | extract_images | Images as base64 (max 10 per call) |
| **OCR** | ocr_document | Force OCR on scanned/image-based PDFs |
| **OCR** | read_image | Extract text from PNG, JPG, TIFF via OCR |
| **Export** | convert_to_markdown | Convert any document to clean Markdown |
**Highlights:**
- **Fast** — mtime-based in-memory caching avoids redundant extraction
- **Multi-format** — PDF, TXT, MD, CSV, DOCX, and images from one server
- **OCR** — automatic fallback to tesseract for scanned documents
- **Secure** — directory-locked with path traversal prevention
- **Portable** — works on macOS and Linux
---
📄 Supported Formats
| Format | Dependencies | Notes |
|--------|-------------|-------|
| PDF | poppler (pdftotext, pdfinfo, pdfimages, pdftoppm) | Full support — text, images, metadata, OCR fallback |
| TXT, MD, CSV | None | Native, zero dependencies |
| DOCX | pandoc (optional) | Word document extraction |
| Images (PNG, JPG, TIFF) | tesseract (optional) | OCR text extraction |
---
📦 Prerequisites
- **Go 1.25+** (install)
- **poppler** — required for PDF support
- **tesseract** _(optional)_ — enables OCR for scanned docs and images
- **pandoc** _(optional)_ — enables DOCX support
> **Note:** TXT, MD, and CSV work out of the box with zero dependencies. Install only what you need.
---
🚀 Installation
From source
Build locally
---
⚙️ Configuration
Go-Docs MCP reads documents from a configured directory. Set DOCS_MCP_DIR to change it:
| Variable | Default | Description |
|----------|---------|-------------|
| DOCS_MCP_DIR | ~/.docs-mcp/documents/ | Directory containing documents to serve |
| PDF_MCP_DIR | _(legacy alias)_ | Backward-compatible alias for DOCS_MCP_DIR |