Permet à un client IA de lire des fichiers DOCX, PDF, Excel et TXT depuis le système de fichiers via un outil unifié.
Aussi connu sous xt765/mcp_documents_reader, mcp-documents-reader
- Étoiles
- 23
- Outils
- 1
- Téléchargements, 30 jours
- 570
- Dernière version
- 1.3.1
- Dernier commit
- 16 oct. 2026
- Licence
- MIT
Qu'est-ce que Document Reader MCP ?
Permet à un client IA de lire des fichiers DOCX, PDF, Excel et TXT depuis le système de fichiers via un outil unifié. Il expose 1 outil, comme filename.
Résumé généré à partir du README du projet
À propos du MCP server Document Reader
Cet outil permet d'extraire du texte de divers formats de fichiers directement au sein de votre assistant IA. Il fournit une interface unique permettant aux agents IA d'accéder au contenu de votre système de fichiers local et de le traiter. En utilisant l'outil read_document, un client IA peut interpréter les données de quatre formats spécifiques : les feuilles de calcul Excel, les documents Word, les PDF et les fichiers texte brut.
Les développeurs peuvent intégrer ce serveur dans des environnements tels que Claude Desktop ou Trae IDE en le configurant via un fichier JSON à l'aide de la commande uvx. Le serveur s'exécute localement et accède aux fichiers via les chemins absolus ou relatifs fournis par l'utilisateur. Il gère la complexité de la détection des types de fichiers et de la sélection du lecteur interne approprié, comme python-docx pour les fichiers Word ou openpyxl pour les fichiers Excel, afin de renvoyer le contenu textuel extrait au modèle.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Document Reader MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Document Reader MCP dans Claude Code
$ claude mcp add mcp-documents-reader -- uvx mcp-documents-readerInstaller Document Reader MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-documents-reader": {
"command": "uvx",
"args": [
"mcp-documents-reader"
]
}
}
}Installer Document Reader MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"mcp-documents-reader": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-documents-reader"
]
}
}
}Installer Document Reader MCP dans VS Code CLI
$ code --add-mcp '{"name":"mcp-documents-reader","type":"stdio","command":"uvx","args":["mcp-documents-reader"]}'Installer Document Reader MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-documents-reader": {
"command": "uvx",
"args": [
"mcp-documents-reader"
]
}
}
}Installer Document Reader MCP dans Codex
$ codex mcp add mcp-documents-reader -- uvx mcp-documents-readerInstaller Document Reader MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-documents-reader] command = "uvx" args = ["mcp-documents-reader"]
Installer Document Reader MCP dans Gemini CLI
$ gemini mcp add -s user mcp-documents-reader uvx -- mcp-documents-readerInstaller Document Reader MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-documents-reader": {
"command": "uvx",
"args": [
"mcp-documents-reader"
]
}
}
}Outils MCP Document Reader 1
Détectés depuis le READMEfilename
| filename | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblext765/mcp_documents_reader is public and reachablegithub.com/xt765/mcp_documents_reader ↗Réussi
- Le nom du package correspond au dépôt sourcemcp-documents-reader names xt765/mcp_documents_reader as sourcepypi.org/project/mcp-documents-reader/ ↗Réussi
- Provenance du build (attestation Sigstore)Sigstore attestation for mcp-documents-readerpypi.org/project/mcp-documents-reader/ ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-16github.com/xt765/mcp_documents_reader ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from mcp-documents-readerRéussi
- Aucun avis critique dans le package ou ses dépendances34 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle1 tool description and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubFeatures
- Multi-format Support: Supports 4 mainstream document formats: Excel (XLSX/XLS), DOCX, PDF, and TXT
- MCP Protocol: Compliant with MCP standards, can be used as a tool for AI assistants like Trae IDE
- Easy Integration: Simple configuration for immediate use
- Reliable Performance: Successfully tested and running in Trae IDE
- File System Support: Reads documents directly from the file system
📚 Documentation
User Guide · API Reference · Contributing · Changelog · License
Architecture
graph TB
A[AI Assistant / User] -->|Call read_document| B[MCP Document Reader]
B -->|Detect file type| C{File Type?}
C -->|.docx| D[DOCX Reader]
C -->|.pdf| E[PDF Reader]
C -->|.xlsx/.xls| F[Excel Reader]
C -->|.txt| G[Text Reader]
D -->|Extract text| H[Return Content]
E -->|Extract text| H
F -->|Extract text| H
G -->|Extract text| H
H -->|Text content| 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:#fff9c4
Supported Formats
| Format | Extensions | MIME Type | Features |
|---|---|---|---|
| Excel | .xlsx, .xls | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet | Sheet and cell data extraction |
| DOCX | .docx | application/vnd.openxmlformats-officedocument.wordprocessingml.document | Text and structure extraction |
| application/pdf | Text extraction | ||
| Text | .txt | text/plain | Plain text reading |
Installation
Using pip (Recommended)
pip install mcp-documents-reader
From Source
git clone https://github.com/xt765/mcp_documents_reader.git
cd mcp_documents_reader
pip install -e .
MCP Tools
This server provides the following tool:
read_document
Read any supported document type with a unified interface.
Arguments:
filename(string, required): Document file path, supports absolute or relative paths.
Configuration
Using in Trae IDE / Claude Desktop
Add the following to your MCP configuration file:
Option 1: Using PyPI (Recommended)
{
"mcpServers": {
"mcp-document-reader": {
"command": "uvx",
"args": [
"mcp-documents-reader"
]
}
}
}
Option 2: Using GitHub repository
{
"mcpServers": {
"mcp-document-reader": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/xt765/mcp_documents_reader",
"mcp_documents_reader"
]
}
}
}
Option 3: Using Gitee repository (Faster access in China)
{
"mcpServers": {
"mcp-document-reader": {
"command": "uvx",
"args": [
"--from",
"git+https://gitee.com/xt765/mcp_documents_reader",
"mcp_documents_reader"
]
}
}
}
Usage
As an MCP Tool
After configuration, AI assistants can directly call the following tool:
# Read a DOCX file
read_document(filename="example.docx")
# Read a PDF file
read_document(filename="example.pdf")
# Read an Excel file
read_document(filename="example.xlsx")
# Read a text file
read_document(filename="example.txt")
As a Python Library
from mcp_documents_reader import DocumentReaderFactory
# Using factory (recommended)
reader = DocumentReaderFactory.get_reader("document.pdf")
content = reader.read("/path/to/document.pdf")
# Check if format is supported
if DocumentReaderFactory.is_supported("file.xlsx"):
reader = DocumentReaderFactory.get_reader("file.xlsx")
content = reader.read("/path/to/file.xlsx")
Tool Interface Details
read_document
Read any supported document type.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| filename | string | ✅ | Document file path, supports absolute or relative paths |
Dependencies
Core Dependencies
mcp>= 1.26.0 - MCP protocol implementationpython-docx>= 1.2.0 - DOCX file readingpypdf>= 6.8.0 - PDF file reading (replaces PyPDF2)openpyxl>= 3.1.5 - Excel file reading
Development Dependencies
pytest>= 8.0.0 - Testing frameworkpytest-asyncio>= 0.24.0 - Async testing supportpytest-cov>= 6.0.0 - Coverage reportingbasedpyright>= 0.28.0 - Type checkingruff>= 0.8.0 - Linting and formatting
License
MIT License
Contributing
Issues and Pull Requests are welcome!
Related Projects
- MCP Document Converter - MCP document converter supporting multiple format conversions
- Model Context Protocol - Official Model Context Protocol documentation
Questions sur Document Reader MCP
Comment ajouter Document Reader MCP à Claude Code ?
Exécutez claude mcp add mcp-documents-reader -- uvx mcp-documents-reader dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Document Reader MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils Document Reader MCP fournit-il ?
Il expose 1 outil, dont filename.
Quels formats de documents ce MCP server prend-il en charge ?
Il lit les fichiers Excel (XLSX/XLS), DOCX, PDF et TXT.
Comment installer le MCP server de lecture de documents ?
Installez-le depuis PyPI avec pip, ou clonez le dépôt pour une installation à partir des sources.
Quel outil le serveur expose-t-il aux clients IA ?
Il expose un outil unique read_document qui prend un nom de fichier en argument et renvoie le texte extrait.
Puis-je l'utiliser comme une bibliothèque Python ?
Oui, via DocumentReaderFactory, qui peut retourner un lecteur pour un fichier donné et vérifier la compatibilité du format.