mcpField
E
ezpzfile

ezpzfile

ローカル
ezpzfile.com生産性54 週間前に更新
リポジトリ公式サイト

ezpzfile について

ezpzfile-mcpは、複数形式のドキュメントの読み取りと変換、PDFや画像の編集、QRコード作成を行うローカルMCPサーバーです。ファイルを端末上で処理するエージェント向けで、韓国語・日本語の形式にも対応し、ファイルはアップロードされません。

主な機能

  1. 01ドキュメントの読み取りと表の抽出
  2. 02ドキュメントとPDFページの変換
  3. 03PDFの編集と情報確認
  4. 04画像のリサイズ・変換・クリーンアップ
  5. 05PNGまたはSVGのQRコード作成

活用シーン

  1. 01オフィス文書からテキストや表を抽出
  2. 02PDFをWord、Excel、HWPに変換
  3. 03画像メタデータの削除や背景の除去

MCP 対応

ezpzfile-mcpはMCPクライアントに、doc_read、doc_convert、pdf_edit、pdf_info、image_edit、qr_makeの6つのファイル処理ツールを公開します。ファイル処理はローカルで行われます。READMEによると、背景除去時にはモデルとランタイムをダウンロードしてキャッシュします。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "ezpzfile-ezpzfile": {
      "command": "npx",
      "args": [
        "-y",
        "ezpzfile-mcp"
      ]
    }
  }
}
起動コマンドnpx -y ezpzfile-mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmezpzfile-mcp0.3.3

ツール

6

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
pathstringはいソースファイル（.hwp、.hwpx、.docx、.pdf、.eml）の絶対パス。相対パスは拒否されます
formatenumいいえmarkdown は、形式が対応している場合（DOCX）、見出し、リスト、表を保持します。デフォルトは texttext | markdown
passwordstringいいえ暗号化された PDF、HWP、HWPX のみ

詳細

ezpzfile-mcp

AI エージェント向けのファイルツールです。ドキュメント（DOCX、PDF、HWP、HWPX、EML、日本語の JTD および XDW）を読み取って変換し、PDF を Word、Excel、または HWP に戻し、PDF を編集し、画像のサイズ変更やクリーニング、背景の切り抜き、QR コードの作成ができます。すべてお使いのマシン上で実行され、ファイルがアップロードされることはありません。

claude mcp add ezpzfile -- npx -y ezpzfile-mcp

npm · ezpzfile.com/mcp · Node 22.13 以降

削減できるもの

同じ 4 つのファイルを 2 つのセッションに用意し、同じタスク文を同じモデルに渡しました。一方はこのサーバーのみを使用でき、もう一方は専用ツールがなく、シェルと Node を自由に使用できました。

ツールなしezpzfile-mcp あり
コスト$0.28$0.13
実時間9:060:39
完了したタスク2 / 44 / 4
ツール呼び出し2010
トークン510,607184,605

コストは 53%、時間は 93%削減されました。トークン数とコストは推定値ではなく、セッションで記録されたメッセージごとの数値を合計したものです。2026-09-12 に測定。

ツールなしのセッションでは、2 つのタスクに着手できませんでした。2 つの韓国語ドキュメント用のライブラリを探してインストールするのに時間を費やしました。この差は上限ではなく下限として捉えてください。4 つすべてを完了させていたら、差はさらに広がっていたでしょう。

ベンチマーク

ツール

ツールは 25 個ではなく 6 個です。ツール定義は会話ごとにモデルのコンテキストに含まれるため、関連する作業を 1 つのツールで扱い、引数で処理を選択します。すべてのツールと引数の一覧は mcp/README.md をご覧ください。

ツール機能
doc_readDOCX、PDF、HWP、HWPX、EML、JTD、XDW からテーブルを含むテキストを抽出するか、ファイルに記録された情報を取得します
doc_convertドキュメントを PDF に変換、PDF を Word、Excel、HWP に変換、PDF のページを画像に変換、シートを CSV または JSON に変換、韓国語形式間で相互変換します
pdf_edit結合、抽出、削除、回転、並べ替え、分割、圧縮、保護、ロック解除、テキスト置換を行います
pdf_infoページ数、ページサイズ、暗号化、メタデータを確認します
image_editサイズ変更、圧縮、変換（iPhone の HEIC にも対応）、EXIF と GPS 情報の削除、背景の切り抜きを行います
qr_makeリンクまたはテキストから PNG または SVG を作成します

構成

パス内容
mcp/パッケージ：サーバー、ツール、ビルド
src/lib/ezpzfile.com と共有するコード
public/vendor/HWP、JTD、XDW のエンジン、libheif、生成 PDF に埋め込まれるフォント（git の管理対象外で、npm パッケージに含めて配布されます）
cd mcp
npm install
npm run build      # writes mcp/dist/index.js and mcp/vendor/
node test/protocol.mjs /path/to/samples

sharp と @napi-rs/canvas はネイティブモジュールのため、インストール時にお使いのプラットフォーム向けにビルドされます。背景の切り抜きを初めて実行すると、背景除去用に 4.4MB のモデルと 14MB のランタイムがダウンロードされ、~/.cache/ezpzfile-mcp にキャッシュされます。ネットワークにアクセスするのはこれだけで、何もアップロードされません。

このリポジトリについて

これは読み取り専用のエクスポートです。作業用コピーはウェブサイトとともに非公開のモノレポにあり、リリースごとにこのリポジトリが再生成されます。プルリクエストではなく、イシューを作成してください。

MIT ライセンスです。詳しくは LICENSE をご覧ください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。