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_keypointssind 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 |
| Direktes Parsen von ZIP+XML (Titel, Absätze, Tabellen) |
HWP |
| hwpx wird nativ unterstützt, |
|
| |
Präsentation |
| Nach Foliennummer + Referentennotizen |
Tabellen |
| Pro Blatt, Auflösung gemeinsamer Zeichenketten |
Daten |
| Inklusive Spaltennamen und Zeilenzahl |
Web & E-Mail |
| Entfernen von Tags, bei E-Mail Kopf + Text |
Text & Code |
| 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.serverWenn 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 |
| Liste der Ordner, die gelesen werden dürfen (durch | Desktop, Dokumente, Downloads |
| Ordner für Zusammenfassungen und Organisationsprotokolle |
|
| Maximale Dateigröße |
|
| Bei | 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 |
| Lesbare Ordner, unterstützte Formate und Limits prüfen |
R |
| Ordner durchsuchen und Dokumentliste (Typ, Größe, Änderungsdatum) anzeigen |
R |
| Struktur, Titel, Schlüsselwörter, repräsentative Sätze. Zur Entscheidung vor dem vollständigen Lesen |
R |
| Textextraktion. Bietet Abschnittslabels und Fortsetzungs-Cursor |
R |
| Volltextsuche in mehreren Dokumenten + Beleg-Snippets |
R |
| Mehrere Dokumente gleichmäßig innerhalb eines Zeichenbudgets exzerpieren |
R |
| Vorschau von Inhalt und Pfad + Ausstellung eines Genehmigungstokens |
W |
| Genehmigte Zusammenfassung im Ausgabeordner speichern |
R |
| Nur Organisationsplan erstellen (keine Dateiänderung) + Genehmigungstoken |
W |
| Genehmigten Plan ausführen (Standard: Kopieren) |
W |
| Nur anhand des Journalprotokolls rückgängig machen |
Empfohlener Ablauf
list_roots
→ scan_documents 어떤 문서가 있는지
→ outline_document 긴 문서는 뼈대부터
→ read_document 원문을 근거로 확보 (필요하면 이어 읽기)
→ (Claude가 요약 작성)
→ preview_save_summary 저장 내용 확인
→ [사용자 승인]
→ save_summaryDas Organisieren erfolgt separat.
preview_organize 계획만 생성 — 파일은 하나도 건드리지 않음
→ [사용자가 계획 확인·승인]
→ apply_organize (기본 copy)
→ 문제가 있으면 undo_last_organizeEs gibt vier Organisationskriterien.
Kriterium | Ergebnisordner |
|
|
| Änderungsmonat wie |
|
|
| In den Regeln festgelegter Name. Beispiel: |
Sicherheitsvorkehrungen
Pfad-Sperre – Alle Eingabepfade werden nach
resolve()daraufhin geprüft, ob sie innerhalb der erlaubten Roots liegen..., symbolische Links und Laufwerkswechsel werden hier blockiert.Schreib-Sperre – Das Speichern ist nur innerhalb des Ausgabeordners möglich. In die Lese-Roots wird nicht geschrieben.
Ausgeschlossene Ordner –
.git,node_modules,.venv,AppDatausw. werden weder durchsucht noch gelesen.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.
Standard ist Kopieren – Das Verschieben von Originalen ist nur mit
DOCS_MCP_ALLOW_MOVE=1möglich.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.pypytest– Extraktion pro Format, Grenzprüfungen, Genehmigungsablauf (Unit)smoke.py– Prüftinitialize → tools/list → tools/callüber echtes stdiosimulate.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 toolsapply_organizeADestructive
승인된 정리 계획을 실제로 수행합니다. 기본은 복사이며, 이동은 서버 설정과 사용자 승인이 모두 있어야 합니다.
Inputs: target_dir (required), approval_token (required), mode, kinds, +5 more. Returns: mode, stage, status, journal, +5 more
build_summary_bundleARead-only
여러 문서를 글자 예산 안에서 고르게 발췌해 한 번에 돌려줍니다. 여러 문서를 묶어 요약할 때 씁니다.
Inputs: paths (required), char_budget. Returns: stage, status, included, documents, +6 more
list_rootsARead-only
이 서버가 읽을 수 있는 폴더, 저장 위치, 지원 형식과 한도를 확인합니다. 다른 도구를 부르기 전에 먼저 호출하세요.
Inputs: no named parameters. Returns: roots, stage, limits, status, +4 more
outline_documentARead-only
문서를 열어 구조(구역·제목·분량)와 키워드를 돌려줍니다. 전문을 읽기 전에 어디를 읽을지 고를 때 씁니다.
Inputs: path (required), keypoint_limit. Returns: kind, path, stage, status, +9 more
preview_organizeARead-only
문서를 어떤 폴더로 나눌지 계획만 만들어 보여줍니다. 파일을 전혀 건드리지 않습니다.
Inputs: target_dir (required), kinds, limit, folder, +3 more. Returns: plan, stage, total, status, +9 more
preview_save_summaryARead-only
요약문을 저장하기 전에 최종 파일 경로와 내용을 미리 보여주고 승인 토큰을 발급합니다. 파일을 쓰지 않습니다.
Inputs: title (required), sources (required), summary_markdown (required), note, +1 more. Returns: stage, status, reminder, target_path, +5 more
read_documentARead-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_documentsARead-only
허용 폴더를 훑어 문서 목록을 최근 수정순으로 돌려줍니다. 파일 내용은 읽지 않습니다.
Inputs: kinds, limit, folder, name_pattern, +1 more. Returns: count, files, stage, stats, +3 more
search_documentsBRead-only
여러 문서의 본문을 실제로 열어 검색어를 찾고, 주변 문장을 근거 스니펫으로 돌려줍니다.
Inputs: query (required), kinds, folder, max_files. Returns: hits, count, query, stage, +4 more
undo_last_organizeADestructive
가장 최근(또는 지정한) 정리 실행을 되돌립니다. 복사본은 지우지 않고 _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
Scored across 11 tools
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.
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.
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.
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
Read and search folders on your own computer with explicit consent. Files are never uploaded.
Convert PDF pages into editable Word-ready text from your AI chat, all offline.
Convert PDFs, Office docs, websites and audio into AI-ready Markdown, then search and ask your docs.
Convert PDF, Word, Excel and scanned documents to Markdown, tables and RAG chunks. OCR.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- FlicenseAqualityDmaintenanceEnables local analysis of unstructured documents (PDF, DOCX, PPTX, SVG, PNG) by extracting text and structure with citation anchors, and verifies summaries against source material before a human approves saving a report.9-
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- FlicenseAqualityDmaintenanceEnables 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-