A
securityF
licenseA
qualityAn MCP server for converting Markdown documents to PDF files.
Last updated -
1
1
JavaScript
mcp-pandoc: ドキュメント変換MCPサーバー
モデルコンテキストプロトコルサーバーのオープンソースプロジェクトに正式に含まれます。🎉
概要
pandocを用いたドキュメント形式変換のためのモデルコンテキストプロトコルサーバー。このサーバーは、書式と構造を維持しながら、異なるドキュメント形式間でコンテンツを変換するためのツールを提供します。
mcp-pandoc は現在開発初期段階にありますのでご注意ください。PDF サポートは現在開発中であり、機能と利用可能なツールは、サーバーの継続的な改善に伴い変更および拡張される可能性があります。
クレジット: このプロジェクトでは、ドキュメント変換にPandoc Python パッケージを使用しており、これがこのプロジェクトの基盤となっています。
デモ
今後もさらに続きます...
ツール
convert-contents- サポートされている形式間でコンテンツを変換します
- 入力:
contents(文字列): 変換するソースコンテンツ (input_file が指定されていない場合は必須)input_file(文字列): 入力ファイルへの完全なパス (内容が指定されていない場合は必須)input_format(文字列): コンテンツのソース形式 (デフォルトはマークダウン)output_format(文字列): ターゲット形式 (デフォルトは markdown)output_file(文字列): 出力ファイルの完全なパス (pdf、docx、rst、latex、epub 形式では必須)
- サポートされている入力/出力形式:
- マークダウン
- html
- 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をインストールする必要があります
- インストールコマンド:
- ファイルパスの要件
- ファイルを保存または変換するときは、ファイル名と拡張子を含む完全なファイルパスを指定する必要があります。
- このツールはファイル名や拡張子を自動的に生成しません
例
✅ 正しい使い方:
❌ 誤った使用法:
よくある問題と解決策
- 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.json - Windows の場合:
%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 の問題ページで問題を開いてください。
- プル リクエストの送信: プル リクエストを作成して、コードベースを改善したり、機能を追加したりします。
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
Pandoc を使用してシームレスなドキュメント形式変換を行う MCP サーバー。Markdown、HTML、PDF、DOCX (.docx)、csv などをサポートします。
Related MCP Servers
- AsecurityAlicenseAqualityA powerful MCP server for fetching and transforming web content into various formats (HTML, JSON, Markdown, Plain Text) with ease.Last updated -414612TypeScriptMIT License
- AsecurityAlicenseAqualityAn MCP server for fetching and transforming web content into various formats.Last updated -44PythonMIT License
- AsecurityAlicenseAqualityConverts various file formats to Markdown using the MarkItDown utility and can be integrated with MCP clients for seamless document processing and conversion.Last updated -26PythonMIT License