Markdownify MCP サーバー - UTF-8 拡張

これは、UTF-8 エンコードのサポートが改善され、多言語コンテンツの処理が最適化された、オリジナルの Markdownify MCP プロジェクトの拡張バージョンです。

中国語の文書

機能強化

• 包括的なUTF-8エンコードのサポートを追加
• 多言語コンテンツの最適化された処理
• Windowsシステムでのエンコードの問題を修正
• エラー処理メカニズムの改善

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

1. 強化されたエンコーディングサポート:
   • すべての操作で完全な UTF-8 をサポート
   • 中国語、日本語、韓国語、その他の非ASCII文字の適切な処理
   • Windows 固有のエンコードの問題を修正しました (cmd.exe と PowerShell の互換性)
2. エラー処理の改善:
   • 英語と中国語の両方で詳細なエラーメッセージ
   • ネットワークの問題に対する例外処理の改善
   • 変換失敗時の適切なフォールバックメカニズム
3. 拡張機能:
   • 複数ファイルのバッチ処理のサポートを追加
   • 強化された YouTube 動画のトランスクリプト処理
   • さまざまなファイル形式からのメタデータ抽出の改善
   • ドキュメントの書式をより適切に保持
4. パフォーマンスの最適化:
   • 大きなファイルの変換におけるメモリ使用量の最適化
   • 多言語コンテンツの処理の高速化
   • 依存関係の競合の軽減
5. より良い開発エクスペリエンス:
   • 包括的なデバッグオプション
   • 詳細なログシステム
   • 環境固有の構成サポート
   • 英語と中国語の両方でわかりやすいドキュメント

特徴

さまざまなファイル形式を Markdown に変換することをサポートします。

• PDFファイル
• 画像（メタデータ付き）
• 音声（書き起こし付き）
• Word文書（DOCX）
• Excel スプレッドシート (XLSX)
• PowerPoint プレゼンテーション (PPTX)
• ウェブコンテンツ:
  • YouTube動画のトランスクリプト
  • 検索結果
  • 一般的なウェブページ
• 既存のMarkdownファイル

クイックスタート

1. このリポジトリをクローンします:
   git clone https://github.com/JDJR2024/markdownify-mcp-utf8.git cd markdownify-mcp-utf8
2. 依存関係をインストールします:
   pnpm install
   注: これにより、 uvおよび関連する Python 依存関係もインストールされます。
3. プロジェクトをビルドします。
   pnpm run build
4. サーバーを起動します。
   pnpm start

要件

• Node.js 16.0以上
• Python 3.8以上
• pnpm パッケージマネージャー
• ギット

詳細なインストールガイド

1. 環境設定

1. Node.js をインストールします。
   • Node.js公式サイトからダウンロード
   • インストールの確認: node --version
2. pnpmをインストールします。
   npm install -g pnpm pnpm --version
3. Python をインストールします。
   • Python公式サイトからダウンロード
   • インストール中にPythonがPATHに追加されていることを確認する
   • インストールの確認: python --version
4. (Windows のみ) UTF-8 サポートを構成する:
   # Set system-wide UTF-8 setx PYTHONIOENCODING UTF-8 # Set current session UTF-8 set PYTHONIOENCODING=UTF-8 # Enable UTF-8 in command prompt chcp 65001

2. プロジェクトのセットアップ

1. リポジトリをクローンします。
   git clone https://github.com/JDJR2024/markdownify-mcp-utf8.git cd markdownify-mcp-utf8
2. Python 仮想環境を作成してアクティブ化します。
   # Windows python -m venv .venv .venv\Scripts\activate # Linux/macOS python3 -m venv .venv source .venv/bin/activate
3. プロジェクトの依存関係をインストールします。
   # Install Node.js dependencies pnpm install # Install Python dependencies (will be handled by setup.sh) ./setup.sh
4. プロジェクトをビルドします。
   pnpm run build

3. 検証

1. サーバーを起動します。
   pnpm start
2. インストールをテストします。
   # Convert a web page python convert_utf8.py "https://example.com" # Convert a local file python convert_utf8.py "path/to/your/file.docx"

使用ガイド

基本的な使い方

1. Webページの変換:
   python convert_utf8.py "https://example.com"
   変換されたマークダウンはconverted_result.mdとして保存されます。
2. ローカルファイルの変換:
   # Convert DOCX python convert_utf8.py "document.docx" # Convert PDF python convert_utf8.py "document.pdf" # Convert PowerPoint python convert_utf8.py "presentation.pptx" # Convert Excel python convert_utf8.py "spreadsheet.xlsx"
3. YouTube 動画の変換:
   python convert_utf8.py "https://www.youtube.com/watch?v=VIDEO_ID"

高度な使用法

1. 環境変数:
   # Set custom UV path export UV_PATH="/custom/path/to/uv" # Set custom output directory export MARKDOWN_OUTPUT_DIR="/custom/output/path"
2. バッチ処理: URL またはファイル パスを含むバッチ ファイル (例: convert_batch.txt ) を作成します。
   https://example1.com https://example2.com file1.docx file2.pdf
   次に以下を実行します:
   while read -r line; do python convert_utf8.py "$line"; done < convert_batch.txt

トラブルシューティング

1. よくある問題:
   • エンコードエラーが表示される場合は、UTF-8が正しく設定されていることを確認してください。
   • Windowsの権限の問題の場合は、管理者として実行してください
   • Pythonパスの問題の場合は、仮想環境がアクティブになっていることを確認してください
2. デバッグ:
   # Enable debug output export DEBUG=true python convert_utf8.py "your_file.docx"

使用法

コマンドライン

WebページをMarkdownに変換する:

ローカルファイルを変換:

デスクトップアプリの統合

このサーバーをデスクトップ アプリと統合するには、アプリのサーバー構成に以下を追加します。

トラブルシューティング

1. エンコーディングの問題
   • 文字エンコードの問題が発生した場合は、 PYTHONIOENCODING環境変数がutf-8に設定されていることを確認してください。
   • Windowsユーザーは、UTF-8サポートを有効にするためにchcp 65001実行する必要があるかもしれません。
2. 権限の問題
   • 十分なファイルの読み取り/書き込み権限があることを確認してください
   • Windowsでは管理者として実行する必要があるかもしれません

謝辞

このプロジェクトは、Zach Caceres 氏のオリジナル作品に基づいています。素晴らしい貢献をしてくださった原作者に感謝申し上げます。

ライセンス

このプロジェクトは引き続きMITライセンスの下でライセンスされます。詳細はLICENSEファイルをご覧ください。

貢献

貢献を歓迎します！プルリクエストを送信する前に、以下の点にご注意ください。

1. コードがプロジェクトのコーディング標準に準拠していることを確認する
2. 必要なテストとドキュメントを追加する
3. READMEの関連セクションを更新する

接触

問題や提案については:

1. 問題を提出する: https://github.com/JDJR2024/markdownify-mcp-utf8/issues
2. プルリクエストを作成: https://github.com/JDJR2024/markdownify-mcp-utf8/pulls
3. メールアドレス: jdidndosmmxmx@gmail.com