mcp-pandoc: ドキュメント変換MCPサーバー
モデルコンテキストプロトコルサーバーのオープンソースプロジェクトに正式に含まれます。🎉
概要
pandocを用いたドキュメント形式変換のためのモデルコンテキストプロトコルサーバー。このサーバーは、書式と構造を維持しながら、異なるドキュメント形式間でコンテンツを変換するためのツールを提供します。
mcp-pandoc は現在開発初期段階にありますのでご注意ください。PDF サポートは現在開発中であり、機能と利用可能なツールは、サーバーの継続的な改善に伴い変更および拡張される可能性があります。
クレジット: このプロジェクトでは、ドキュメント変換にPandoc Python パッケージを使用しており、これがこのプロジェクトの基盤となっています。
Related MCP server: MCP NPX Fetch
デモ
今後もさらに続きます...
ツール
convert-contentsサポートされている形式間でコンテンツを変換します
入力:
contents(文字列): 変換するソースコンテンツ (input_file が指定されていない場合は必須)input_file(文字列): 入力ファイルへの完全なパス (内容が指定されていない場合は必須)input_format(文字列): コンテンツのソース形式 (デフォルトはマークダウン)output_format(文字列): ターゲット形式 (デフォルトは markdown)output_file(文字列): 出力ファイルの完全なパス (pdf、docx、rst、latex、epub 形式では必須)
サポートされている入力/出力形式:
マークダウン
html
pdf
docx
最初
ラテックス
EPUB
TXT
注: 高度な形式 (pdf、docx、rst、latex、epub) の場合、output_file パスが必要です。
サポートされている形式
現在サポートされている形式:
基本形式（直接変換）：
プレーンテキスト（.txt）
マークダウン (.md)
HTML (.html)
高度な形式 (完全なファイル パスが必要です):
PDF (.pdf) - TeX Live のインストールが必要です
DOCX (.docx)
RST (.rst)
LaTeX (.tex)
EPUB（.epub）
注: 高度な形式の場合:
ファイル名と拡張子を含む完全なファイルパスが必要です
PDF 変換には TeX Live のインストールが必要です(「重要な要件」セクションを参照 -> macOS の場合:
brew install texlive)出力パスが指定されていない場合:
基本形式: 変換されたコンテンツをチャットに表示します
高度なフォーマット: システムの一時ディレクトリ (Unix システムでは /tmp/) に保存できます
使用方法と設定
公開されたものを使用するには
⚠️ 重要事項
重要な要件
PDF変換の前提条件
PDF変換を行う前にTeX Liveをインストールする必要があります
インストールコマンド:
# Ubuntu/Debian sudo apt-get install texlive-xetex # macOS brew install texlive # Windows # Install MiKTeX or TeX Live from: # https://miktex.org/ or https://tug.org/texlive/
ファイルパスの要件
ファイルを保存または変換するときは、ファイル名と拡張子を含む完全なファイルパスを指定する必要があります。
このツールはファイル名や拡張子を自動的に生成しません
例
✅ 正しい使い方:
❌ 誤った使用法:
よくある問題と解決策
PDF変換に失敗する
エラー: 「xelatex が見つかりません」
解決策: まずTeX Liveをインストールします（上記のインストールコマンドを参照）
ファイル変換に失敗する
エラー:「無効なファイルパス」
解決策: ファイル名と拡張子を含む完全なパスを指定します
例:
/path/to/document.pdfではなく/path/to/
フォーマット変換に失敗する
エラー:「サポートされていない形式です」
解決策: サポートされている形式のみを使用します。
基本: txt、html、マークダウン
上級: pdf、docx、rst、latex、epub
クイックスタート
インストール
オプション 1: claude_desktop_config.json 構成ファイルを使用して手動でインストールする
MacOSの場合:
open ~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows の場合:
%APPDATA%/Claude/claude_desktop_config.json
ℹ️ ローカルにクローンしたプロジェクトパスに置き換えます
オプション2: Smithery経由で公開サーバー構成を自動的にインストールする
次の bash コマンドを実行して、 Smithery経由で Claude Desktop 用に公開されたmcp-pandoc pypi を自動的にインストールします。
注: ローカルに構成された mcp-pandoc を使用するには、上記の「開発/非公開サーバー構成」の手順に従ってください。
発達
建築と出版
配布用のパッケージを準備するには:
依存関係を同期し、ロックファイルを更新します。
パッケージディストリビューションをビルドします。
これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。
PyPI に公開:
注: 環境変数またはコマンド フラグを使用して PyPI 資格情報を設定する必要があります。
トークン:
--tokenまたはUV_PUBLISH_TOKENまたはユーザー名/パスワード:
--username/UV_PUBLISH_USERNAMEおよび--password/UV_PUBLISH_PASSWORD
デバッグ
MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。
次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。
起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。
貢献
mcp-pandoc の機能強化への貢献を歓迎します。参加方法は以下の通りです。
問題を報告: バグを見つけた場合や機能のリクエストがある場合は、 GitHub の問題ページで問題を開いてください。
プル リクエストの送信: プル リクエストを作成して、コードベースを改善したり、機能を追加したりします。