Skip to main content
Glama
local-docs-mcp

local-docs-mcp

local-docs-mcp

Ein persönlicher MCP-Server, der Dokumente auf dem lokalen PC liest und beim Zusammenfassen und Ordnen hilft. Er extrahiert Text aus PDF, Word, Excel, PowerPoint, HWP, Markdown, CSV usw. und verarbeitet das Speichern von Zusammenfassungen sowie die Dateiorganisation mit einem Genehmigungsverfahren.

  • Er nutzt kein Netzwerk. Es sind keine API-Schlüssel erforderlich.

  • Das Zusammenfassen übernimmt dieser Server nicht. Er extrahiert den Originaltext präzise; die Zusammenfassung schreibt Claude. (Die vom Server gelieferten machine_keypoints sind eine frequenzbasierte maschinelle Extraktion und keine Zusammenfassung.)

  • Außerhalb der erlaubten Ordner kann er nicht lesen. Beim Verschieben oder Speichern von Dateien ist immer eine Genehmigung erforderlich.

Unterstützte Formate

Typ

Erweiterungen

Methode

Dokumente

.docx .docm

Direktes Parsen von ZIP+XML (Titel, Absätze, Tabellen)

HWP

.hwpx / .hwp

hwpx wird nativ unterstützt, .hwp bestmögliche Extraktion bei installiertem olefile

PDF

.pdf

pypdf (Label p.N pro Seite)

Präsentation

.pptx .pptm

Nach Foliennummer + Referentennotizen

Tabellen

.xlsx .xlsm

Pro Blatt, Auflösung gemeinsamer Zeichenketten

Daten

.csv .tsv .json

Inklusive Spaltennamen und Zeilenzahl

Web & E-Mail

.html .htm .xml .eml

Entfernen von Tags, bei E-Mail Kopf + Text

Text & Code

.md .txt .log .yaml .py .js usw.

Automatische Erkennung von UTF-8/CP949/EUC-KR

.doc, .xls, .ppt (alte Binärformate) werden nicht gelesen; stattdessen wird empfohlen, sie „im Format mit x zu speichern“.

Related MCP server: file-analysis

Installation

Python 3.11 oder höher ist erforderlich.

python -m venv .venv && .venv/Scripts/pip install -e ".[formats,dev]"

Unter macOS und Linux wird .venv/bin/pip verwendet. [formats] installiert pypdf für PDF und olefile für .hwp (binär); ohne sie funktionieren die übrigen Formate weiterhin.

Registrierung in Claude Code

<PROJECT_DIR> ist der absolute Pfad, in den dieses Repository geklont wurde, <HOME> das Benutzer-Home-Verzeichnis.

claude mcp add local-docs --scope user --env DOCS_MCP_ROOTS="<HOME>/Desktop;<HOME>/Documents" --env DOCS_MCP_OUTPUT="<HOME>/Desktop/docs-mcp-out" -- <PROJECT_DIR>/.venv/Scripts/python.exe -m docs_mcp.server

Wenn Sie es nur innerhalb dieses Repositories verwenden möchten, kopieren Sie .mcp.json.example in .mcp.json und ersetzen Sie <PROJECT_DIR> und <HOME> durch die tatsächlichen Pfade. .mcp.json wird nicht im Repository nachverfolgt, da die Pfade je nach Maschine unterschiedlich sind.

Umgebungsvariablen

Variable

Bedeutung

Standardwert

DOCS_MCP_ROOTS

Liste der Ordner, die gelesen werden dürfen (durch ; getrennt)

Desktop, Dokumente, Downloads

DOCS_MCP_OUTPUT

Ordner für Zusammenfassungen und Organisationsprotokolle

<HOME>/Desktop/docs-mcp-out

DOCS_MCP_MAX_FILE_MB

Maximale Dateigröße

20

DOCS_MCP_ALLOW_MOVE

Bei 1 ist das Verschieben von Originalen beim Organisieren erlaubt

Nicht gesetzt (nur Kopieren)

11 Werkzeuge

Sie werden getrennt als schreibgeschützt (R) und schreibend (W) registriert, sodass der Host unterschiedliche Genehmigungs-UI anzeigen kann.

Werkzeug

Funktion

R

list_roots

Lesbare Ordner, unterstützte Formate und Limits prüfen

R

scan_documents

Ordner durchsuchen und Dokumentliste (Typ, Größe, Änderungsdatum) anzeigen

R

outline_document

Struktur, Titel, Schlüsselwörter, repräsentative Sätze. Zur Entscheidung vor dem vollständigen Lesen

R

read_document

Textextraktion. Bietet Abschnittslabels und Fortsetzungs-Cursor

R

search_documents

Volltextsuche in mehreren Dokumenten + Beleg-Snippets

R

build_summary_bundle

Mehrere Dokumente gleichmäßig innerhalb eines Zeichenbudgets exzerpieren

R

preview_save_summary

Vorschau von Inhalt und Pfad + Ausstellung eines Genehmigungstokens

W

save_summary

Genehmigte Zusammenfassung im Ausgabeordner speichern

R

preview_organize

Nur Organisationsplan erstellen (keine Dateiänderung) + Genehmigungstoken

W

apply_organize

Genehmigten Plan ausführen (Standard: Kopieren)

W

undo_last_organize

Nur anhand des Journalprotokolls rückgängig machen

Empfohlener Ablauf

list_roots
  → scan_documents          어떤 문서가 있는지
  → outline_document        긴 문서는 뼈대부터
  → read_document           원문을 근거로 확보 (필요하면 이어 읽기)
  → (Claude가 요약 작성)
  → preview_save_summary    저장 내용 확인
  → [사용자 승인]
  → save_summary

Das Organisieren erfolgt separat.

preview_organize   계획만 생성 — 파일은 하나도 건드리지 않음
  → [사용자가 계획 확인·승인]
  → apply_organize (기본 copy)
  → 문제가 있으면 undo_last_organize

Es gibt vier Organisationskriterien.

Kriterium

Ergebnisordner

by_kind

01_문서 02_PDF 03_발표자료 04_표계산 …

by_month

Änderungsmonat wie 202608

by_kind_month

02_PDF/202608

by_keyword

In den Regeln festgelegter Name. Beispiel: {"계약서": ["계약","contract"]}

Sicherheitsvorkehrungen

  1. Pfad-Sperre – Alle Eingabepfade werden nach resolve() daraufhin geprüft, ob sie innerhalb der erlaubten Roots liegen. .., symbolische Links und Laufwerkswechsel werden hier blockiert.

  2. Schreib-Sperre – Das Speichern ist nur innerhalb des Ausgabeordners möglich. In die Lese-Roots wird nicht geschrieben.

  3. Ausgeschlossene Ordner – .git, node_modules, .venv, AppData usw. werden weder durchsucht noch gelesen.

  4. Genehmigungstoken – Es ist der Hash des Vorschauinhalts. Ändert sich auch nur ein Zeichen des Inhalts, wird das Token ungültig und Speichern/Organisieren wird abgelehnt. Das Token gewährleistet jedoch nur technische Integrität und ersetzt nicht die Benutzergenehmigung.

  5. Standard ist Kopieren – Das Verschieben von Originalen ist nur mit DOCS_MCP_ALLOW_MOVE=1 möglich.

  6. Kein Löschen – Auch das Rückgängigmachen löscht keine Dateien, sondern verschiebt sie in den Ordner _trash.

Verifizierung

.venv/Scripts/python.exe -m pytest -q
.venv/Scripts/python.exe scripts/smoke.py
.venv/Scripts/python.exe scripts/simulate.py
  • pytest – Extraktion pro Format, Grenzprüfungen, Genehmigungsablauf (Unit)

  • smoke.py – Prüft initialize → tools/list → tools/call über echtes stdio

  • simulate.py – Erstellt einen virtuellen Dokumentensatz und reproduziert den gesamten Ablauf über eine echte MCP-Verbindung. Es werden 12 virtuelle Dokumente erstellt (Sitzungsprotokolle, Verträge, Angebote, Präsentationen, PDF, CP949-Notizen usw.) und der Ablauf von Durchsuchen → Zusammenfassung speichern → Organisieren → Rückgängigmachen durchlaufen. Dabei wird geprüft, ob blockierte Vorgänge (Lesen außerhalb der Roots, Token-Fälschung, Verschieben von Originalen) tatsächlich blockiert werden. Es läuft in einem temporären Ordner und räumt sich am Ende selbst auf. Um Ergebnisse zu behalten, übergeben Sie einen Ordner als Argument.

Einschränkungen

  • Gescannte Bild-PDFs enthalten keinen Text. Es wird kein OCR durchgeführt, nur eine Warnung ausgegeben.

  • Excel-Datumszellen können als interne Seriennummern erscheinen.

  • .hwp (binär) ist eine bestmögliche Extraktion. Die Reihenfolge von Tabellen und Fußnoten kann vom Original abweichen.

  • Text in Bildern wird in keinem Format gelesen.

Lizenz

MIT – LICENSE

Available Tools

11 tools
apply_organizeA
Destructive

승인된 정리 계획을 실제로 수행합니다. 기본은 복사이며, 이동은 서버 설정과 사용자 승인이 모두 있어야 합니다.

Inputs: target_dir (required), approval_token (required), mode, kinds, +5 more. Returns: mode, stage, status, journal, +5 more

build_summary_bundleA
Read-only

여러 문서를 글자 예산 안에서 고르게 발췌해 한 번에 돌려줍니다. 여러 문서를 묶어 요약할 때 씁니다.

Inputs: paths (required), char_budget. Returns: stage, status, included, documents, +6 more

list_rootsA
Read-only

이 서버가 읽을 수 있는 폴더, 저장 위치, 지원 형식과 한도를 확인합니다. 다른 도구를 부르기 전에 먼저 호출하세요.

Inputs: no named parameters. Returns: roots, stage, limits, status, +4 more

outline_documentA
Read-only

문서를 열어 구조(구역·제목·분량)와 키워드를 돌려줍니다. 전문을 읽기 전에 어디를 읽을지 고를 때 씁니다.

Inputs: path (required), keypoint_limit. Returns: kind, path, stage, status, +9 more

preview_organizeA
Read-only

문서를 어떤 폴더로 나눌지 계획만 만들어 보여줍니다. 파일을 전혀 건드리지 않습니다.

Inputs: target_dir (required), kinds, limit, folder, +3 more. Returns: plan, stage, total, status, +9 more

preview_save_summaryA
Read-only

요약문을 저장하기 전에 최종 파일 경로와 내용을 미리 보여주고 승인 토큰을 발급합니다. 파일을 쓰지 않습니다.

Inputs: title (required), sources (required), summary_markdown (required), note, +1 more. Returns: stage, status, reminder, target_path, +5 more

read_documentA
Read-only

문서 본문을 텍스트로 읽습니다. 구역 라벨([p.3], [슬라이드 2] 등)이 함께 붙어 요약에 근거를 달 수 있습니다.

Inputs: path (required), max_chars, start_char, only_labels. Returns: kind, path, text, stage, +8 more

save_summaryA

사용자가 승인한 요약을 출력 폴더에 저장합니다. preview_save_summary의 토큰이 필요합니다.

Inputs: title (required), sources (required), approval_token (required), summary_markdown (required), +2 more. Returns: path, bytes, stage, status, +2 more

scan_documentsA
Read-only

허용 폴더를 훑어 문서 목록을 최근 수정순으로 돌려줍니다. 파일 내용은 읽지 않습니다.

Inputs: kinds, limit, folder, name_pattern, +1 more. Returns: count, files, stage, stats, +3 more

search_documentsB
Read-only

여러 문서의 본문을 실제로 열어 검색어를 찾고, 주변 문장을 근거 스니펫으로 돌려줍니다.

Inputs: query (required), kinds, folder, max_files. Returns: hits, count, query, stage, +4 more

undo_last_organizeA
Destructive

가장 최근(또는 지정한) 정리 실행을 되돌립니다. 복사본은 지우지 않고 _trash 폴더로 옮깁니다.

Inputs: journal_path. Returns: mode, stage, status, journal, +4 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: listing roots, scanning, outlining, reading, searching, bundling summaries, preview/save summaries, preview/apply organize, and undo. No two tools appear to overlap in functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., list_roots, scan_documents, preview_organize). Even compound verbs like preview_save_summary maintain the pattern.

    Tool Count5/5

    11 tools is well-scoped for a local docs management server, covering read, search, summarize, save, and organize workflows without bloat. Each tool earns its place in the workflow.

    Completeness5/5

    The tool surface covers the full lifecycle for reading and managing documents: listing, scanning, outlining, reading, searching, bundling, saving summaries with preview, organizing with preview and apply, and undo for corrections. No obvious dead ends or missing operations for the stated purpose.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with local documents (PDF, Markdown, TXT) through tools for discovery, reading, extraction, summarization, comparison, keyword extraction, search, and analysis, ensuring privacy and offline capability.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables local folder analysis of unstructured documents (PDF, DOCX, PPTX, TXT, SVG, PNG, CSV, XLSX) by extracting structure, reading content, and generating reports, with a strict approval gate before any save operation.
      -
    • F
      license
      A
      quality
      D
      maintenance
      Enables read-only scanning and text extraction from PDF, DOCX, PPTX, SVG, and PNG files in a local folder, providing the raw text to AI models for summarization or analysis without an external LLM API.
      5
      -