MCP Document Converter

mcp-server-convert

ドキュメントを Markdown に変換する軽量な Model Context Protocol (MCP) サーバーです。PDF、DOCX、HTML、EPUB、CSV、JSON、プレーンテキストファイルに対応しています。

ドキュメントの内容を取り込み、理解する必要がある AI エージェントに最適です。

特長

• 📄 マルチフォーマット対応：PDF、DOCX、HTML、EPUB、CSV、JSON、画像（OCR 経由）、プレーンテキスト
• 🔧 MCP ツール 6 種類：convert_file、convert_url、list_supported_formats、batch_convert、extract_metadata、convert_directory
• 🐍 コア機能に外部依存関係なし：Python 標準ライブラリと HTML 用の markdownify を使用
• ⚡ 高速：メモリ内で処理し、一時ファイルを使用しません
• 🐳 Docker 対応：Dockerfile 1 つで、コマンド 1 つでデプロイ

クイックスタート

インストールと実行

# Clone
git clone https://github.com/demo112/mcp-server-convert.git
cd mcp-server-convert

# Install dependencies
pip install -r requirements.txt

# Run
python -m mcp_server_convert

Claude Code で設定する

MCP 設定（~/.claude/settings.json）に追加します：

{
  "mcpServers": {
    "convert": {
      "command": "python",
      "args": ["-m", "mcp_server_convert"],
      "cwd": "/path/to/mcp-server-convert"
    }
  }
}

Docker

docker build -t mcp-server-convert .
docker run -i --rm mcp-server-convert

Docker で設定する

{
  "mcpServers": {
    "convert": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "/path/to/files:/data", "mcp-server-convert"]
    }
  }
}

ツール

convert_file

ローカルファイルを Markdown に変換します。

パラメーター：

• file_path（string、必須）：ファイルの絶対パス
• max_length（int、任意）：出力の最大文字数（デフォルト：50000）

convert_url

URL を取得し、そのコンテンツを Markdown に変換します。

パラメーター：

• url（string、必須）：取得して変換する URL
• max_length（int、任意）：出力の最大文字数（デフォルト：50000）

batch_convert

複数のファイルを一度に変換します。

パラメーター：

• file_paths（文字列の配列、必須）：ファイルパスのリスト
• max_length_per_file（int、任意）：ファイルごとの最大文字数（デフォルト：50000）

convert_directory

ディレクトリ内の対応するすべてのファイルを変換します。

パラメーター：

• dir_path（string、必須）：ディレクトリのパス
• recursive（bool、任意）：サブディレクトリを含めるかどうか（デフォルト：true）
• max_files（int、任意）：変換するファイルの最大数（デフォルト：20）

extract_metadata

ファイル全体を変換せずに、メタデータを抽出します。

パラメーター：

• file_path（string、必須）：ファイルのパス

list_supported_formats

対応するすべてのファイル拡張子と変換方法を一覧表示します。

対応形式

形式	拡張子	方法
PDF	.pdf	PyMuPDF (fitz)
Word	.docx	python-docx
HTML	.html、.htm	markdownify
EPUB	.epub	ebooklib
CSV	.csv	pandas → Markdown テーブル
JSON	.json	整形済み Markdown コードブロック
XML	.xml	xmltodict → Markdown
Excel	.xlsx	openpyxl → Markdown テーブル
PowerPoint	.pptx	python-pptx → Markdown スライド
テキスト	.txt、.md、.rst、.log	そのまま出力
画像	.png、.jpg	pytesseract OCR（利用可能な場合）

サポート

このツールがワークフローに役立つ場合は、開発への支援をご検討ください：

• GitHub Sponsors： Liberapay 経由で支援
• ETH： 0xddD9f45e14c92846f47C1c1A4431aC2b41D87273

ライセンス

MIT