Mineru Open Mcp

MinerU Open MCP

MinerU のドキュメント解析機能を MCP ツールとして公開する、MinerU 公式の MCP サーバーです。MinerU に対応した MCP クライアントを接続すると、PDF、Word 文書、PowerPoint ファイル、画像を Markdown に変換できます。

API キーは不要です — Flash モードは登録不要かつ無料で、すぐに利用できますが、制限は厳しめです。MINERU_API_TOKEN を設定すると、より高い制限と追加の出力形式を利用できます。

サンドボックスを使用する MCP クライアントについての注意 - 一部の MCP クライアントでは、入力ボックスにドラッグしたファイルが一時ディレクトリ内のサンドボックスに置かれます。ローカルファイルをアップロードして解析する必要がある場合は、サーバーがファイルを見つけられない事態を避けるため、プロンプトに対象ファイルのフルパスを指定してください。

---

⚡ 最も手軽な実行方法 — uvx（インストール不要）

mineru-open-mcp は PyPI で公開されています。uv がインストールされていれば、別途インストールすることなく、直接実行できます。

MCP クライアントの設定

stdio — Claude Desktop、Cursor、Windsurf

MCP クライアントが mineru-open-mcp をサブプロセスとして自動的に起動します。

uvx を使用する場合（推奨 — 常に最新バージョンを実行）：

{
  "mcpServers": {
    "mineru": {
      "command": "uvx",
      "args": ["mineru-open-mcp"],
      "env": {
        "MINERU_API_TOKEN": "your_key_here"
      }
    }
  }
}

API キーがありませんか？ サーバーは Flash モードで動作します — 無料で利用でき、Markdown のみを出力します。詳しくはFlash モードのドキュメントをご覧ください。

mineru-open-mcp が PATH にありませんか？ フルパス（"/Users/you/.local/bin/mineru-open-mcp"）を使用するか、上記の uvx を使う方法を利用してください。後者なら自動的に処理されます。

使用例

例 1：対象ページの範囲を指定してローカルの PDF 文書を解析する

ユーザープロンプト：「この PDF の 3〜5 ページを Markdown に変換してください：<your_path_to_file>」 処理内容：

• MinerU が PDF をアップロードして解析します
• 表（HTML）と数式（LaTeX）を保持した、整形済みの Markdown を返します
• 長さが許容範囲内であれば、出力パスと、必要に応じて利用できる ZIP の URL とともに、Markdown のテキストをチャット内に返します
• MCP クライアントが内容を要約します

例 2：ファイルをホストするリモート URL を解析する

ユーザープロンプト：「この論文から内容を抽出してください：https://arxiv.org/pdf/2509.22186」 処理内容：

• MinerU が論文を Markdown に解析します
• MCP クライアントが表を整形して説明します

例 3：ページ範囲を個別に指定してローカルの PDF ファイルを解析する

ユーザープロンプト：「<file1> の 1〜5 ページ、<file2> の 2〜9 ページ、<file3> の 3 ページを Markdown に変換してください」 処理内容：

• MinerU がファイルを個別にアップロードして解析します
• 対象の出力形式、ダウンロード用の ZIP URL、Markdown の概要、および出力の保存先として指定したディレクトリを返します
• MCP クライアントが内容を使ってさらに分析します

例 4：詳細なカスタム設定

ユーザープロンプト 1：「この韓国語ファイルを pipeline モデルで解析してください：your_path_here」 ユーザープロンプト 2：「your_path_here を解析して、Markdown を your_output_dir に保存してください」 処理内容：

• Pipeline モデルは MinerU サービスが提供する別のモデルです（ちなみに、デフォルトでは VLM モデルが選択されます）
• プロンプトを工夫することで、モデル、OCR 言語、さらには OUTPUT_DIR とは異なる出力ディレクトリも指定できます
• リクエストは parse_documents ツールのパラメーターに変換され、あとは MinerU が処理します。

streamable-http — Web ベースの MCP クライアント

サーバーを手動で起動してから、クライアントに接続先を指定します：

MINERU_API_TOKEN=your_key mineru-open-mcp --transport streamable-http --port 8001

{
  "mcpServers": {
    "mineru": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8001/mcp"
    }
  }
}

機能

• parse_documents — ローカルファイルやリモート URL を Markdown に変換します。入力形式は PDF、画像（png/jpg/jpeg/jp2/webp/gif/bmp）、Doc、Docx、Ppt、PPTx に対応しています。Flash Mode では xlsx にも対応しています。
• get_ocr_languages — MinerU がサポートするすべての OCR 言語を一覧表示します。
• Flash mode — API キーなしで動作します（無料、Markdown 出力のみ。PDF/画像/Docx/PPTx/xls/xlsx に対応）。すべての機能を利用するには、MINERU_API_TOKEN を指定してください。指定すると flash mode は無効になります。
• 出力の動作 — 単一ファイルの解析では、デフォルトで Markdown をインラインで返します。バッチ解析では結果をディスクに保存し、ファイルのメタデータを返します。インライン出力の上限を超えるコンテンツもローカルに保存され、extract_path を通じて返されます。
• 2 つのトランスポートモード — stdio、streamable-http

---

環境変数

変数	説明	デフォルト
MINERU_API_TOKEN	MinerU API トークンです。すべての機能を利用するには、MinerU で申請してください。指定しない場合は flash mode が有効になります。	—
OUTPUT_DIR	バッチ解析やインライン出力の上限超過など、解析結果をローカルに保存する必要がある場合に使用するディレクトリです。	~/mineru-downloads

プライバシーポリシー

mineru-open-mcp は、ドキュメントを解析するために公式 MinerU API（mineru.net）に接続します。

• 送信されるデータ：解析対象として指定したドキュメントの内容（ファイルまたは URL）
• データの保存：解析結果は MinerU のサーバーで一時的にキャッシュされます。トレーニングには使用されません。
• サードパーティ：MinerU API（mineru.net） — OpenDatalab プライバシーポリシーをご覧ください。
• ローカルデータ：解析結果は指定した出力ディレクトリに保存されます。ログファイルは（ENABLE_LOG=true の場合のみ）MINERU_LOG_DIR に保存されます。
• お問い合わせ：[email protected]（または MinerU-Ecosystem で issue を作成してください）