MCP Document Reader

MCP ドキュメントリーダー

MCP（Model Context Protocol）ドキュメントリーダー — 複数の形式のドキュメントを読み取り、AI エージェントがドキュメントを実際に「読める」ようにする強力な MCP ツールです。

🌐 言語：英語 | 中文

特長

• 複数形式に対応：主流のドキュメント形式である Excel（XLSX/XLS）、DOCX、PDF、TXT の4形式に対応
• MCP プロトコル：MCP 標準に準拠しており、Trae IDE などの AI アシスタントのツールとして利用できます
• 簡単に統合：簡単な設定ですぐに使用できます
• 信頼性の高いパフォーマンス：Trae IDE でのテストに成功し、動作を確認済みです
• ファイルシステムに対応：ファイルシステムからドキュメントを直接読み取ります

---

📚 ドキュメント

ユーザーガイド · API リファレンス · コントリビューション · 変更履歴 · ライセンス

---

アーキテクチャ

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

対応形式

形式	拡張子	MIME タイプ	特長
Excel	.xlsx, .xls	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet	シートとセルのデータ抽出
DOCX	.docx	application/vnd.openxmlformats-officedocument.wordprocessingml.document	テキストと構造の抽出
PDF	.pdf	application/pdf	テキスト抽出
テキスト	.txt	text/plain	プレーンテキストの読み取り

インストール

pip を使用（推奨）

pip install mcp-documents-reader

ソースからインストール

git clone https://github.com/xt765/mcp_documents_reader.git
cd mcp_documents_reader
pip install -e .

MCP ツール

このサーバーは次のツールを提供します。

read_document

統一されたインターフェースで、対応する任意のドキュメント形式を読み取ります。

引数：

• filename（string、必須）：ドキュメントのファイルパス。絶対パスと相対パスに対応しています。

設定

Trae IDE / Claude Desktop での使用

次の内容を MCP 設定ファイルに追加してください。

オプション 1：PyPI を使用（推奨）

{
  "mcpServers": {
    "mcp-document-reader": {
      "command": "uvx",
      "args": [
        "mcp-documents-reader"
      ]
    }
  }
}

オプション 2：GitHub リポジトリを使用

{
  "mcpServers": {
    "mcp-document-reader": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/xt765/mcp_documents_reader",
        "mcp_documents_reader"
      ]
    }
  }
}

オプション 3：Gitee リポジトリを使用（中国国内からのアクセスが高速）

{
  "mcpServers": {
    "mcp-document-reader": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://gitee.com/xt765/mcp_documents_reader",
        "mcp_documents_reader"
      ]
    }
  }
}

使用方法

MCP ツールとして使用

設定後、AI アシスタントは次のツールを直接呼び出せます。

# 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")

Python ライブラリとして使用

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")

ツールインターフェースの詳細

read_document

サポートされている任意のドキュメント形式を読み取ります。

パラメーター：

パラメーター	型	必須	説明
filename	string	✅	ドキュメントのファイルパス。絶対パスまたは相対パスを指定できます

依存関係

コア依存関係

• mcp >= 1.26.0 - MCP プロトコルの実装
• python-docx >= 1.2.0 - DOCX ファイルの読み取り
• pypdf >= 6.8.0 - PDF ファイルの読み取り（PyPDF2 の代替）
• openpyxl >= 3.1.5 - Excel ファイルの読み取り

開発依存関係

• pytest >= 8.0.0 - テストフレームワーク
• pytest-asyncio >= 0.24.0 - 非同期テストのサポート
• pytest-cov >= 6.0.0 - カバレッジレポート
• basedpyright >= 0.28.0 - 型チェック
• ruff >= 0.8.0 - リンティングとフォーマット

ライセンス

MIT ライセンス

コントリビューション

Issue とプルリクエストを歓迎します！

関連プロジェクト

• MCP Document Converter - 複数の形式変換に対応した MCP ドキュメントコンバーター
• Model Context Protocol - Model Context Protocol の公式ドキュメント