Markdownify

🚀 Markdownify MCP サーバー（UTF - 8 版）

このプロジェクトは、元の Markdownify プロジェクトをベースに開発された拡張版です。UTF - 8 コードをより良くサポートするために設計されています。以下にプロジェクトのドキュメントを示します。

🚀 クイックスタート

この Markdownify MCP サーバー（UTF - 8 版）を使用するには、まず必要な環境をセットアップし、インストール手順に従って操作する必要があります。詳細は以下の「📦 インストール」セクションを参照してください。

✨ 主な機能

• 様々な形式のファイルを Markdown に変換することができます。対応形式は以下の通りです：
  • DOCX
  • PDF
  • PPTX
  • XLSX
  • YouTube 動画リンク
  • ウェブページの内容
• コマンドラインツールとデスクトップアプリケーションの統合をサポートします。
• Node.js と Python スクリプト環境と互換性があります。

✨ 主な改良点

1. 完全な UTF - 8 サポート
   プロジェクト全体が最適化され、中国語やその他の UTF - 8 文字を処理する際の安定性が向上しています。

2. Windows システムの互換性向上
   Windows オペレーティングシステムにおけるいくつかの問題が修正され、ユーザー体験が向上しています。

3. 改良された機能モジュール

   • より強力なファイル解析能力
   • より多くのファイル形式（PDF、PPTX、XLSX など）をサポート
   • YouTube 動画の処理効率が向上

4. 強化されたエラー処理
   より詳細なエラーログとカスタム出力パス機能を備えています。

🔍 原プロジェクトとの主な違い

• UTF - 8 サポートの最適化
  • 原プロジェクトは中国語やその他の非英語文字の処理に問題がありましたが、現バージョンでは完全に改善されています。
• Windows システムサポートの強化
  • Windows ユーザーが使用中に遭遇するいくつかの問題が解決されています。
• 新機能の追加
  • より柔軟な環境変数設定（UV_PATH と MARKDOWN_OUTPUT_DIR など）を提供します。

📦 インストール

インストール要件

1. システム
   • Windows、macOS または Linux
2. 依存関係
   • Node.js（推奨バージョン：16+）
   • Python 3.x

インストール手順

ステップ 1：リポジトリをクローンする

git clone https://github.com/JDJR2024/markdownify-mcp-utf8.git
cd markdownify-mcp-utf8

ステップ 2：依存関係をインストールする

npm install
pip install -r requirements.txt

ステップ 3：サーバーを起動する

node dist/index.js

💻 使用例

コマンドラインでの使用

ウェブページを Markdown に変換する

python convert_utf8.py "https://example.com"

ローカルファイルを変換する

• DOCX ファイル：

python convert_utf8.py "document.docx"

• PDF ファイル：

python convert_utf8.py "document.pdf"

• PowerPoint ファイル：

python convert_utf8.py "presentation.pptx"

• Excel ファイル：

python convert_utf8.py "spreadsheet.xlsx"

YouTube 動画を変換する

python convert_utf8.py "https://www.youtube.com/watch?v=VIDEO_ID"

バッチ処理操作

1. 処理する URL またはファイルパスを含むテキストファイル（例：convert_batch.txt）を作成します。

https://example1.com
https://example2.com
file1.docx
file2.pdf

2. 以下のコマンドを実行してバッチ処理を行います。

while read -r line; do python convert_utf8.py "$line"; done < convert_batch.txt

環境変数の設定

カスタムパスを設定する

• UV パスを設定する：

export UV_PATH="/custom/path/to/uv"

• 出力ディレクトリを設定する：

export MARKDOWN_OUTPUT_DIR="/output/path"

Python スクリプトでこれらの環境変数を使用する

デスクトップアプリケーションの統合

Node.js 環境を設定する

node dist/index.js

Python スクリプトの呼び出し

import subprocess

def convert_file(file_path):
    subprocess.run(["python", "convert_utf8.py", file_path])

if __name__ == "__main__":
    file_path = input("ファイルパスを入力してください：")
    convert_file(file_path)

⚠️ 注意事項

⚠️ 重要提示

• 正しい依存関係をインストールしてください。Node.js と Python のバージョンは要件を満たす必要があります。
• 大きなファイルを処理する際は、パフォーマンスに注意してください。大型の PDF または PPT ファイルを処理するには、より多くのメモリと時間が必要になる場合があります。
• 問題が発生した場合は、詳細なログを確認して迅速に問題を特定してください。

🤝 貢献とフィードバック

Pull Request と Issue の提出を歓迎します！

• リポジトリのアドレス：https://github.com/JDJR2024/markdownify-mcp-utf8
• 質問や提案がある場合は、your.email@example.com までご連絡ください。

ありがとうございます！このプロジェクトが皆様の作業に役立つことを願っています。