Dokumen-Pintar

Universal MCP server for cross-format document CRUD, lint, and template authoring

Read, write, search, lint, and author text, Office, and PDF files from any AI agent that supports the Model Context Protocol.

Features

• Multi-root Sandbox — Define multiple workspace roots with per-root writable control. All paths outside the sandbox are rejected.
• 10 Formats — Plain text, Markdown, LaTeX, JSON / YAML, CSV / TSV, XML / SVG, DOCX, XLSX, PPTX, PDF, plus image EXIF.
• 62 MCP Tools — File & content CRUD, structured access, batch operations, search, versioning, metadata, authoring, image extraction, sections, templates, TOC, bibliography, document compare, lint — all exposed as callable tools.
• Automatic Versioning — Copy-on-write snapshots on every write operation. Undo, diff, restore, and purge anytime.
• Structured Access — JSONPath for JSON / YAML (incl. list indices), XPath for XML, cell / range / sheet for XLSX, paragraph / paragraph_runs / table cells for DOCX, slide for PPTX, page for PDF.
• Authoring — Generate DOCX or PDF from a JSON spec or Markdown, render Jinja2-style DOCX templates, convert DOCX → Markdown.
• Document Lint — Pluggable rule registry with built-in presets (default, academic_id, academic_id_kp, academic_id_skripsi) for Indonesian academic documents.
• Indonesian Stemming (optional) — Sastrawi-based morphological matching so mengatakan, berkata, perkataan collapse during search.
• Semantic Search (optional) — Vector search powered by sentence-transformers; enable via config.
• Audit Trail — Every mutation logged to JSONL with timestamp and operation details.
• 2 Transports — stdio (Claude Desktop, Cursor, VS Code, Windsurf) and HTTP / SSE.

Supported Formats

Quick Start

1. Install

pip install dokumen-pintar

With Indonesian stemming:

pip install dokumen-pintar[indonesian]

With semantic search:

pip install dokumen-pintar[semantic]

2. Create a Config

dokumen-pintar-init

Or create one manually:

{
  "roots": [
    { "name": "documents", "path": "~/Documents", "writable": true },
    { "name": "projects",  "path": "~/Projects",  "writable": true }
  ]
}

Six pre-tuned profiles ship in docs/profiles/ — copy personal.json for daily desktop use, research.json for thesis libraries, or team-server.json for HTTP deployment.

3. Run

dokumen-pintar --config dokumen-pintar.config.json

4. Connect to an AI Client

Claude Desktop — Add to claude_desktop_config.json:

{
  "mcpServers": {
    "dokumen-pintar": {
      "command": "dokumen-pintar",
      "args": ["--config", "/path/to/dokumen-pintar.config.json"]
    }
  }
}

Cursor / VS Code / Windsurf — Use the same stdio transport. Point your IDE's MCP settings to the dokumen-pintar command and config path.

Tools Overview

62 MCP tools organised by category:

*Only registered when semantic_search.enabled = true and [semantic] extras are installed.

Bundled templates

• academic_id/kp_basic — generic Indonesian Kerja Praktik report skeleton (cover, lembar pengesahan, kata pengantar, BAB I/II, log book, daftar pustaka).

Documentation

Full docs on GitHub: github.com/firdausmntp/Dokumen-Pintar

• USAGE.md — Workspace URIs, every tool with JSON examples, recipes
• CONFIG.md — All config fields with types, defaults, and notes
• TOOLS.md — Full reference for all 62 tools
• ARCHITECTURE.md — Module map, request flow, versioning, safety
• BENCHMARK.md — Performance baselines and methodology
• profiles/ — Six pre-tuned config presets
• AGENTS.md — Contributor guide

License

MIT — 2026 firdausmntp