MCP Document Reader
Funktionen
Lesen und Schreiben: Kann Dokumente lesen und Word- / PowerPoint-Dateien basierend auf strukturierten Parametern erstellen
Breite Formatunterstützung: Unterstützt TXT, CSV, Markdown, DOC, DOCX, PDF, PPT, PPTX, EPUB, XLSX, XLS
Strukturiertes Schreiben: Unterstützt die Erstellung von Absätzen, Tabellen, Titelseiten, Aufzählungspunkten und Präsentationstabellen
Export alter Formate: Bei installierter LibreOffice-Instanz können
.docund.pptexportiert werdenMCP-Protokoll: Entspricht dem MCP-Standard und kann als Werkzeug für KI-Assistenten (wie Trae IDE) verwendet werden
Einfache Integration: Sofort einsatzbereit nach einfacher Konfiguration
Zuverlässige Leistung: Automatisierte Tests decken Lesen, Erstellen, Konvertierungs-Fallbacks und Werkzeugschnittstellen ab
Dateisystemunterstützung: Direktes Lesen und Schreiben von Dokumenten aus dem Dateisystem
Related MCP server: MCP Documents
📚 Dokumentationszentrum
Benutzerhandbuch · API-Referenz · Beitragsleitfaden · Änderungsprotokoll · Lizenz
Architektur
graph TB
A[AI Assistant / User<br/>AI 助手 / 用户] -->|Call MCP tools<br/>调用 MCP 工具| B[MCP Document Reader<br/>MCP 文档读取器]
B -->|Read<br/>读取| C[Document Readers<br/>文档读取器]
B -->|Generate<br/>生成| D[Document Writers<br/>文档生成器]
C -->|TXT / CSV / MD| E[Text-based Readers<br/>文本类读取器]
C -->|DOC / DOCX| F[Word Readers<br/>Word 读取器]
C -->|PPT / PPTX| G[Presentation Readers<br/>演示读取器]
C -->|PDF / EPUB / Excel| H[Structured Readers<br/>结构化读取器]
D -->|write_word_document| I[DOCX Builder<br/>DOCX 生成器]
D -->|write_presentation| J[PPTX Builder<br/>PPTX 生成器]
I -->|Optional conversion<br/>可选转换| K[LibreOffice -> DOC]
J -->|Optional conversion<br/>可选转换| L[LibreOffice -> PPT]
E --> M[Return text / metadata<br/>返回文本 / 元数据]
F --> M
G --> M
H --> M
K --> M
L --> M
M --> A
style A fill:#e1f5ff
style B fill:#fff4e1
style C fill:#f0f0f0
style D fill:#e8f5e9
style E fill:#e8f5e9
style F fill:#e8f5e9
style G fill:#e8f5e9
style H fill:#fff9c4Unterstützte Formate
Fähigkeit | Format | Dateiendung | Beschreibung |
Lesen | Text |
| Unterstützt Extraktion von Text mit verschiedenen Kodierungen |
Lesen | CSV |
| Normalisiert zu tabulatorgetrenntem Text |
Lesen | Markdown |
| Direkte Extraktion von Markdown-Text |
Lesen | Word |
|
|
Lesen |
| Textextraktion | |
Lesen | PowerPoint |
|
|
Lesen | EPUB |
| Extraktion von Kapiteln basierend auf der Spine-Reihenfolge |
Lesen | Excel |
| Extraktion von Arbeitsblättern und Zelleninhalten |
Erstellen | Word |
| Native Erstellung, unterstützt Absätze und Tabellen |
Erstellen | Word |
| Erstellung über |
Erstellen | PowerPoint |
| Native Erstellung, unterstützt Titel, Textkörper, Aufzählungspunkte, Tabellen |
Erstellen | PowerPoint |
| Erstellung über |
Installation
Verwendung von pip (empfohlen)
pip install mcp-documents-readerWenn Sie die PowerPoint-Erstellungsfunktion benötigen, stellen Sie sicher, dass python-pptx in der Laufzeitumgebung verfügbar ist.
Wenn Sie alte Formate wie .doc oder .ppt exportieren müssen, installieren Sie LibreOffice und stellen Sie sicher, dass soffice oder libreoffice im PATH enthalten ist.
Installation aus dem Quellcode
git clone https://github.com/xt765/mcp_documents_reader.git
cd mcp_documents_reader
pip install -e .MCP-Werkzeuge
Dieser Server stellt die folgenden Werkzeuge bereit:
read_document
Verwendet eine einheitliche Schnittstelle zum Lesen jedes unterstützten Dokumenttyps.
Parameter:
filename(string, erforderlich): Pfad zur Dokumentdatei, unterstützt absolute oder relative Pfade.
extract_document_images
Extrahiert eingebettete Bilder aus DOCX-Dateien und gibt strukturierte JSON-Metadaten zurück.
Parameter:
filename(string, erforderlich): Pfad zur DOCX-Datei.output_dir(string, optional): Verzeichnis zum Exportieren der Bilder.
write_word_document
Erstellt ein .docx Word-Dokument oder exportiert ein .doc über eine LibreOffice-Konvertierung.
Parameter:
filename(string, erforderlich): Ausgabepfad, die Endung muss.docxoder.docsein.title(string, optional): Dokumenttitel.paragraphs(string-Array, optional): Absätze, die in der angegebenen Reihenfolge geschrieben werden.tables(object-Array, optional): Tabellendefinition, unterstützttitle,headers,rows.
write_presentation
Erstellt eine .pptx Präsentation oder exportiert eine .ppt über eine LibreOffice-Konvertierung.
Parameter:
filename(string, erforderlich): Ausgabepfad, die Endung muss.pptxoder.pptsein.title(string, optional): Titel des Titelschlittens.subtitle(string, optional): Untertitel des Titelschlittens.slides(object-Array, optional): Foliendefinition, unterstützttitle,paragraphs,bullets,table.
Konfiguration
Verwendung in Trae IDE / Claude Desktop
Fügen Sie den folgenden Inhalt zu Ihrer MCP-Konfigurationsdatei hinzu:
Option 1: Verwendung von PyPI (empfohlen)
{
"mcpServers": {
"mcp-document-reader": {
"command": "uvx",
"args": [
"mcp-documents-reader"
]
}
}
}Option 2: Verwendung des GitHub-Repositorys
{
"mcpServers": {
"mcp-document-reader": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/xt765/mcp_documents_reader",
"mcp_documents_reader"
]
}
}
}Option 3: Verwendung des Gitee-Repositorys (schnellerer Zugriff in China)
{
"mcpServers": {
"mcp-document-reader": {
"command": "uvx",
"args": [
"--from",
"git+https://gitee.com/xt765/mcp_documents_reader",
"mcp_documents_reader"
]
}
}
}Verwendung
Als MCP-Werkzeug verwenden
Nach der Konfiguration kann der KI-Assistent die folgenden Werkzeuge direkt aufrufen:
# 读取 DOCX 文件
read_document(filename="example.docx")
# 读取演示文稿
read_document(filename="example.pptx")
# 生成 DOCX 报告
write_word_document(
filename="report.docx",
title="周报",
paragraphs=["本周总结", "下周计划"],
tables=[
{
"title": "指标表",
"headers": ["名称", "数值"],
"rows": [["线索", 42], ["成交", 8]],
}
],
)
# 生成 PPTX 汇报
write_presentation(
filename="briefing.pptx",
title="季度汇报",
subtitle="Q2",
slides=[
{
"title": "亮点",
"paragraphs": ["概述段落"],
"bullets": ["重点 A", "重点 B"],
}
],
)Als Python-Bibliothek verwenden
from mcp_documents_reader import DocumentReaderFactory
# 使用工厂类(推荐)
reader = DocumentReaderFactory.get_reader("document.pdf")
content = reader.read("/path/to/document.pdf")
# 检查格式是否支持
if DocumentReaderFactory.is_supported("file.xlsx"):
reader = DocumentReaderFactory.get_reader("file.xlsx")
content = reader.read("/path/to/file.xlsx")Details zur Werkzeugschnittstelle
read_document
Liest jeden unterstützten Dokumenttyp.
Parameter | Typ | Erforderlich | Beschreibung |
filename | string | ✅ | Pfad zur Dokumentdatei, unterstützt absolute oder relative Pfade |
extract_document_images
Extrahiert eingebettete Bilder aus DOCX-Dateien.
Parameter | Typ | Erforderlich | Beschreibung |
filename | string | ✅ | Pfad zur DOCX-Datei |
output_dir | string | ❌ | Optionales Verzeichnis zum Exportieren der Bilder |
write_word_document
Erstellt direkt DOCX oder exportiert DOC über LibreOffice-Konvertierung.
Parameter | Typ | Erforderlich | Beschreibung |
filename | string | ✅ | Ausgabepfad, die Endung muss |
title | string | ❌ | Optionaler Dokumenttitel |
paragraphs | string[] | ❌ | Absätze, die in der angegebenen Reihenfolge geschrieben werden |
tables | object[] | ❌ | Tabellendefinition, unterstützt |
write_presentation
Erstellt direkt PPTX oder exportiert PPT über LibreOffice-Konvertierung.
Parameter | Typ | Erforderlich | Beschreibung |
filename | string | ✅ | Ausgabepfad, die Endung muss |
title | string | ❌ | Titel des Titelschlittens |
subtitle | string | ❌ | Untertitel des Titelschlittens |
slides | object[] | ❌ | Foliendefinition, unterstützt |
Abhängigkeiten
Kernabhängigkeiten
mcp>= 1.26.0 - Implementierung des MCP-Protokollspython-docx>= 1.2.0 - DOCX-Lesen und Word-Dokumenterstellungpython-pptx>= 0.6.23 - PowerPoint-Dokumenterstellungpypdf>= 6.8.0 - PDF-Dateilesen (ersetzt PyPDF2)openpyxl>= 3.1.5 - Excel-Dateilesen
Optionale Laufzeitabhängigkeiten
LibreOffice- Muss installiert sein, wenn alte Formate wie.docoder.pptexportiert werden sollenantiword/catppt- Optionale Hilfsbefehle beim Lesen alter.doc/.pptFormate
Entwicklungsabhängigkeiten
pytest>= 8.0.0 - Test-Frameworkpytest-asyncio>= 0.24.0 - Unterstützung für asynchrone Testspytest-cov>= 6.0.0 - Abdeckungsberichtbasedpyright>= 0.28.0 - Typüberprüfungruff>= 0.8.0 - Code-Linting und Formatierung
Lizenz
Dieses Projekt ist unter der MIT-Lizenz quelloffen.
Dieses Projekt basiert auf dem exzellenten Open-Source-Projekt xt765/mcp_documents_reader und wurde darauf aufbauend weiterentwickelt.
Wir haben derzeit hauptsächlich die folgenden Fähigkeiten hinzugefügt und verbessert:
Fähigkeit zur Extraktion von Bildern aus Dokumenten
Arbeitsabläufe zum Schreiben und Erstellen von Word- und PowerPoint-Dokumenten
Vollständigere Unterstützung für die Dokumentenerstellung in MCP-Szenarien
Ein herzliches Dankeschön an den ursprünglichen Autor des Repositorys für die grundlegenden Fähigkeiten und die Open-Source-Arbeit.
Beitrag
Issues und Pull Requests sind willkommen!
Verwandte Projekte
MCP Document Converter - MCP-Dokumentenkonverter, unterstützt die Konvertierung verschiedener Formate
Model Context Protocol - Offizielle Dokumentation des Model Context Protocol
Available Tools
4 toolsextract_document_imagesB
Extracts embedded images from a DOCX file and returns structured JSON metadata.
:param filename: Path to the DOCX document :param output_dir: Optional directory to save extracted images :return: JSON payload containing extracted image metadata and saved file paths
Inputs: filename (required), output_dir. Returns: result
read_documentB
Reads and extracts text from a specified document file. Supports TXT, CSV, Markdown, DOC, DOCX, PDF, PPT, PPTX, EPUB, and Excel (XLSX, XLS) files.
:param filename: Path to the document file to read (supports absolute or relative paths) :return: Extracted text from the document
Inputs: filename (required). Returns: result
write_presentationC
Generates a PowerPoint presentation in PPTX format, or PPT via LibreOffice conversion.
:param filename: Target output path ending with .pptx or .ppt :param title: Optional title slide title :param subtitle: Optional title slide subtitle :param slides: Optional slide definitions containing title, paragraphs, bullets, and table :return: JSON payload describing the generated file path and format
Inputs: filename (required), title, subtitle, slides. Returns: result
write_word_documentB
Generates a Word document in DOCX format, or DOC via LibreOffice conversion.
:param filename: Target output path ending with .docx or .doc :param title: Optional document title :param paragraphs: Optional paragraph list written in order :param tables: Optional table definitions using title, headers, and rows :return: JSON payload describing the generated file path and format
Inputs: filename (required), title, paragraphs, tables. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: extract_document_images extracts images from DOCX, read_document reads text from various file types, write_presentation creates PowerPoint files, and write_word_document creates Word documents. There is no overlap in functionality, making tool selection straightforward for an agent.
All tool names follow a consistent verb_noun pattern (e.g., extract_document_images, read_document, write_presentation, write_word_document). The naming is uniform and predictable, with no deviations or mixed conventions.
With 4 tools, the count is reasonable for a document reader server, covering reading, extraction, and writing for common document types. It is slightly lean but well-scoped, as each tool serves a distinct and useful function without redundancy.
The tool set covers reading and writing for key document formats (Word, PowerPoint, PDF, etc.) and image extraction, but there are notable gaps. For example, it lacks tools for updating or editing existing documents, converting between formats, or handling other common operations like document merging or metadata manipulation, which could limit agent workflows.
Maintenance
Related MCP Connectors
Document conversion MCP server: PDF to Markdown, image OCR, spreadsheet parsing.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Related MCP Servers
- FlicenseBqualityDmaintenanceMCP server for Office document automation, enabling AI assistants to create, read, and clone Word/Excel/PPT templates while preserving formatting.41-
- AlicenseCqualityDmaintenanceA unified MCP server for document processing that enables creating, editing, and converting Word documents (DOCX), PDFs, Markdown, and images, with support for templates, formatting, and batch operations.100MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that provides document conversion and processing tools, enabling AI assistants to handle document formats through natural language.-
- FlicenseNot gradedqualityDmaintenanceMCP server for document conversion and processing, enabling AI assistants to handle various document formats.-