FILE CONVERTER MCP

🚀 Pandoc 多サーバ制御プロトコル（MCP）サーバ

Pandoc-MCP サーバは、Pandoc をベースにしたツールで、様々なファイル形式の変換と処理をサポートしています。このドキュメントでは、このサーバの構築と実行方法、および LangChain などの MCP クライアントとの統合方法について詳しく説明します。

✨ 主な機能

• 多形式変換：Markdown、Word、PDF などの形式のファイルを相互に変換できます。
• リモート制御：HTTP プロトコルを通じてサービスを提供し、リモートでファイル処理機能を呼び出せます。
• Docker 対応：Docker イメージの構築方法を提供し、迅速なデプロイと実行を容易にします。
• ドキュメント管理：バッチ処理、バージョン管理、およびドキュメントの保存をサポートします。

📦 インストール

サーバー側のインストール

方法 1：Docker を使用したインストール（推奨）

1. イメージの取得

   docker pull your_username/pandoc-mcp-server:latest
   

2. コンテナの起動

   docker run -it --rm -v $(pwd):/data your_username/pandoc-mcp-server:latest
   

3. サービスへのアクセス：サーバーが起動したら、http://localhost:8000/sse でサービスにアクセスできます。

方法 2：ローカルインストール（手動設定が必要）

1. 依存関係のインストール

   • Python 3.10 以上をインストールします。
   • Pandoc ツールチェーンをインストールします (pandoc --version)。
   • LaTeX 環境をインストールします (pdflatex --version)。

2. コードリポジトリのクローン

   git clone https://github.com/your_username/pandoc-mcp-server.git
   cd pandoc-mcp-server
   

3. 仮想環境の作成（推奨）

   python -m venv venv
   source venv/bin/activate  # Linux/macOS
   # または：venv\Scripts\activate  # Windows
   

4. Python パッケージのインストール

   pip install -r requirements.txt
   

5. サーバーの起動

   python pandoc_mcp_server.py
   

💻 使用例

基本的な使用法

クライアント統合例（LangChain を例とする）

from langchain.agents import MultiServerMCPClient

# クライアントの初期化
client = MultiServerMCPClient(
    server_url="http://localhost:8000/sse",
    token="your_token"
)

# ファイル変換サービスの呼び出し
response = client.invoke("将 input.md 转换为 PDF")
print(response)

高度な使用法

1. ファイル形式の変換

• サポートされる形式：Markdown、.docx、PDF など。
• 使用コマンド

  # Markdown を PDF に変換
  ./pandoc-mcp convert input.md output.pdf --format=pdf
  
  # ファイルのバッチ処理
  ./pandoc-mcp batch process *.md output/
  

2. ドキュメント管理

• バージョン管理：ファイルの履歴バージョン管理をサポートします。
• 保存場所：デフォルトでは /data/documents ディレクトリに保存されます。

3. 高度な機能

• カスタムテンプレート：templates ディレクトリを設定することで、カスタムの Pandoc テンプレートを使用できます。
• ログ記録：サーバーは詳細なログ出力をサポートし、デバッグや監視に便利です。

サンプルシナリオ

シナリオ 1：オンラインドキュメント変換サービス

# サービスを起動し、ポート 8000 をバインド
docker run -it --rm -p 8000:8000 your_username/pandoc-mcp-server:latest

シナリオ 2：Word ファイルのバッチ処理

# 現在のディレクトリ内のすべての .docx ファイルを PDF に変換
./pandoc-mcp batch convert *.docx output/pdf/

📚 ドキュメント

プロジェクト構造

.
├── pandoc_mcp_server.py    # メインプログラムのエントリーポイント
├── requirements.txt        # Python 依存関係の管理
├── Dockerfile              # Docker イメージの構築ファイル
└── templates/             # Pandoc テンプレートのディレクトリ

クイックスタート

ステップ 1：Docker イメージの構築

docker build -t your_username/pandoc-mcp-server .

ステップ 2：コンテナの実行

docker run -it --rm -v $(pwd):/data your_username/pandoc-mcp-server:latest

よくある質問

1. ヘルプを取得する方法は？

   • pandoc-mcp --help を参照してください。
   • プロジェクトのコミュニティディスカッショングループに参加するか、ISSUE を提出してください。

2. エラーの処理方法は？

   • ログ出力を確認してください (docker logs)。
   • すべての依存関係が正しくインストールされていることを確認してください。

プロジェクトへの貢献

Fork と PR を歓迎します！

• 機能拡張を提案してください。
• 既知の問題を修正してください。
• より多くのファイル形式のサポートを追加してください。

上記の手順に従えば、Pandoc-MCP サーバーを簡単に構築し、効率的なドキュメント管理と変換を実現できます。