convez.ai
MCP ServerIntegração & APIsIntermediário
drolosoft

Go-Docs MCP

drolosoft/go-docs-mcp

Servidor MCP multi-formato: PDF, DOCX, CSV, imagens — um binário, 13 ferramentas

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP em Go para acesso a documentos em múltiplos formatos (PDF, TXT, MD, DOCX, CSV, imagens). Oferece 13 ferramentas incluindo leitura completa, busca full-text, OCR, extração de tabelas e imagens, com instalação por single binary e zero dependências em runtime.

Instalação

$npx convez-ai drolosoft/go-docs-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
12
Forks
3
Acompanhando
0
Saúde
37%
Último commit
há 4 dias
Versão
v1.5.0
Issues abertas
1
Contribuidores
1

Casos de uso

  • Processar e extrair texto de múltiplos formatos de documentos simultaneamente
  • Buscar conteúdo em documentos com full-text search e contexto
  • Converter documentos para Markdown mantendo estrutura e tabelas
  • Fazer OCR em PDFs escaneados e imagens para extrair texto

Veredito

Solução técnica robusta que unifica acesso a múltiplos formatos em um único servidor MCP. Destaca-se pela abordagem minimalista em Go (sem dependências runtime), cobertura ampla de formatos e capacidade OCR — ideal para pipelines que manipulam documentos heterogêneos.

README

A tradução para o português deste README ainda está na fila.

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.

go install github.com/drolosoft/go-docs-mcp@latest
# That's it. Single binary, starts in milliseconds.

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 MCPOthers
Single binary, no runtimeYesNeed Node/Python
go install one-linerYesnpm+deps or pip+venv
Multi-format (6 types)YesOne format each
Full-text searchYesPartial or none
OCR (scanned PDFs + images)YesRare
Image & table extractionYesPartial
Document outlineYesRare
Fetch from URLYesRare
Dir-locked, read-onlyYesVaries
Smart cachingYesNo
Fully offlineYesYes

Go-Docs MCP reads them all from a single binary — fast, secure, and dependency-free at runtime.


📋 Features — 13 Tools

CategoryToolDescription
Discoverylist_documentsList all documents with metadata (format, pages, size)
Discoverylist_formatsList supported formats and dependency status
Readingread_documentFull text, specific page, or page ranges from any format
Readingread_urlDownload from URL and extract text (50MB max)
Readingget_document_summaryFirst 3 pages as a quick overview
Searchsearch_documentCase-insensitive full-text search with context
Analysisget_document_metadataTitle, author, dates, version, page count
Analysisget_document_outlineTable of contents / bookmarks
Analysisextract_tablesTables as structured data
Analysisextract_imagesImages as base64 (max 10 per call)
OCRocr_documentForce OCR on scanned/image-based PDFs
OCRread_imageExtract text from PNG, JPG, TIFF via OCR
Exportconvert_to_markdownConvert 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

FormatDependenciesNotes
PDFpoppler (pdftotext, pdfinfo, pdfimages, pdftoppm)Full support — text, images, metadata, OCR fallback
TXT, MD, CSVNoneNative, zero dependencies
DOCXpandoc (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
# macOS
brew install poppler
brew install tesseract        # optional: OCR
brew install pandoc           # optional: DOCX

# Debian/Ubuntu
apt install poppler-utils
apt install tesseract-ocr     # optional: OCR
apt install pandoc            # optional: DOCX

# Fedora/RHEL
dnf install poppler-utils
dnf install tesseract         # optional: OCR
dnf install pandoc            # optional: DOCX

Note: TXT, MD, and CSV work out of the box with zero dependencies. Install only what you need.


🚀 Installation

From source

go install github.com/drolosoft/go-docs-mcp@latest

Build locally

git clone https://github.com/drolosoft/go-docs-mcp.git
cd go-docs-mcp
make build      # produces ./go-docs-mcp
make install    # installs to /usr/local/bin/

⚙️ Configuration

Go-Docs MCP reads documents from a configured directory. Set DOCS_MCP_DIR to change it:

VariableDefaultDescription
DOCS_MCP_DIR~/.docs-mcp/documents/Directory containing documents to serve
PDF_MCP_DIR(legacy alias)Backward-compatible alias for DOCS_MCP_DIR

Place your documents in the directory and the server finds them automatically. All supported formats are detected.


💡 Usage

With Claude Code

Add to your .claude/settings.json:

{
  "mcpServers": {
    "docs": {
      "command": "go-docs-mcp",
      "env": {
        "DOCS_MCP_DIR": "/path/to/your/documents"
      }
    }
  }
}

With Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "docs": {
      "command": "/usr/local/bin/go-docs-mcp",
      "env": {
        "DOCS_MCP_DIR": "/path/to/your/documents"
      }
    }
  }
}

With any MCP client

The server communicates over stdio using JSON-RPC 2.0:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | go-docs-mcp

📖 Tool Reference

list_documents

Lists all documents in the configured directory with format detection.

Parameters: None

Example output:

[
  {
    "filename": "architecture-guide.pdf",
    "format": "pdf",
    "title": "architecture-guide",
    "pages": 42,
    "size_bytes": 1048576
  },
  {
    "filename": "notes.md",
    "format": "markdown",
    "title": "notes",
    "size_bytes": 4096
  }
]

list_formats

Lists all supported document formats and their dependency status.

Parameters: None


read_document

Reads the extracted text content of a document. Automatically falls back to OCR if the document is image-based/scanned and pdftotext returns empty text.

Parameters:

NameTypeRequiredDescription
filenamestringYesThe document filename to read
pagenumberNoSingle page number (1-based). Omit for full text.
pagesstringNoPage ranges, e.g. "1-5", "10", "1-3,7,10-12". Overrides page.

Example input:

{
  "filename": "architecture-guide.pdf",
  "pages": "1-3,10-12"
}

search_document

Searches within a document for lines matching a query. Returns matches with 2 lines of context and approximate page numbers.

Parameters:

NameTypeRequiredDescription
filenamestringYesThe document filename to search
querystringYesSearch query (case-insensitive)

Example output:

Found 3 matches for 'microservice' in architecture-guide.pdf:

--- Match 1 (page ~2, line 45) ---
  The system is composed of several
> microservice components that communicate
  via gRPC and message queues.

get_document_summary

Returns the text from the first 3 pages of a document as a quick summary.

Parameters:

NameTypeRequiredDescription
filenamestringYesThe document filename to summarize

get_document_metadata

Returns full document metadata.

Parameters:

NameTypeRequiredDescription
filenamestringYesThe document filename to get metadata for

Example output:

{
  "title": "Architecture Guide",
  "author": "Jane Doe",
  "subject": "System Design",
  "creator": "LaTeX",
  "producer": "pdfTeX",
  "creation_date": "Thu May 15 10:30:00 2025",
  "modification_date": "Thu May 15 10:30:00 2025",
  "pages": 42,
  "file_size_bytes": 1048576,
  "pdf_version": "1.5"
}

get_document_outline

Extracts the document outline (table of contents / bookmarks) as a structured list.

Parameters:

NameTypeRequiredDescription
filenamestringYesThe document filename to extract outline from

extract_tables

Extracts tables from a document as structured data.

Parameters:

NameTypeRequiredDescription
filenamestringYesThe document filename to extract tables from
pagenumberNoSpecific page to extract from. Omit for all pages.

extract_images

Extracts images from a document as base64-encoded data. Returns up to 10 images per call.

Parameters:

NameTypeRequiredDescription
filenamestringYesThe document filename to extract images from
pagenumberNoSpecific page to extract from. Omit for all pages.

Example output:

[
  {
    "page": 1,
    "index": 0,
    "format": "jpeg",
    "width": 800,
    "height": 600,
    "data_base64": "/9j/4AAQSkZJRg..."
  }
]

read_url

Downloads a document from a URL and extracts its text content. Maximum file size: 50MB.

Parameters:

NameTypeRequiredDescription
urlstringYesThe URL of the document to download and read
pagesstringNoPage ranges to extract, e.g. "1-5". Omit for full text.

Example input:

{
  "url": "https://example.com/report.pdf",
  "pages": "1-3"
}

ocr_document

Forces OCR on a PDF document using tesseract. Useful for scanned/image-based PDFs or when pdftotext returns garbled text. Requires tesseract and pdftoppm.

Note: read_document already auto-detects image-based PDFs and falls back to OCR. Use ocr_document when you want to force OCR regardless, or need to specify a non-English language.

Parameters:

NameTypeRequiredDescription
filenamestringYesThe PDF filename to OCR
pagenumberNoSpecific page to OCR (1-based). Omit for all pages.
languagestringNoTesseract language code (default: eng). Use spa, fra, etc.

Example input:

{
  "filename": "scanned-contract.pdf",
  "page": 1,
  "language": "spa"
}

read_image

Extracts text from an image file using OCR. Supports PNG, JPG, and TIFF. Requires tesseract.

Parameters:

NameTypeRequiredDescription
filenamestringYesThe image filename to read (PNG, JPG, TIFF)
languagestringNoTesseract language code (default: eng).

Example input:

{
  "filename": "receipt.png",
  "language": "eng"
}

🔒 Security

  • Directory-locked — only files within DOCS_MCP_DIR are accessible
  • Path traversal prevention — filenames sanitized; ../ rejected
  • Extension filter — only supported formats served
  • Read-only — no write operations
  • URL downloads — 50MB limit, Content-Type validated, temp files cleaned immediately

🛠️ Development

make build     # Build the binary
make test      # Run tests with race detector
make clean     # Remove build artifacts

Project structure

go-docs-mcp/
  main.go              # MCP server setup, 12 tool registrations
  internal/
    pdf/
      reader.go        # Document extraction, caching, search, metadata, images, OCR
  Makefile             # Build targets
  go.mod               # Module definition

🦙 Glama Score


📄 License

MIT - Copyright 2026 Drolosoft


💛 Support


Drolosoft — Tools we wish existed

Ver o original no GitHub

Bom para

Relacionados