Mineru MCP

🚀 mineru-mcp

MinerU のドキュメント解析API用のMCPサーバーです。PDF、DOC、画像からテキスト、表、数式を抽出します。

✨ 主な機能

• VLMモデル — 複雑なドキュメントに対して90%以上の精度を達成します。
• パイプラインモデル — 単純なドキュメントを高速に処理します。
• ローカルファイルアップロード — ディスクからファイルをアップロードし、一括解析を行います。
• バッチ処理 — 一度に最大200個のドキュメントを解析できます。
• ダウンロードとリネーム — 元のファイル名でマークダウンを抽出します。
• ページ範囲指定 — 特定のページのみを抽出できます。
• 109言語のOCRサポート
• Claude Code向けに最適化 — 他のアプローチと比べて73%のトークン削減が可能です。

🛠️ ツール

📦 インストール

Node.js 18以上と MinerU APIキー が必要です。

CLIインストール（ワンライナー）

# Claude Code
claude mcp add mineru-mcp -e MINERU_API_KEY=your-api-key -- npx -y mineru-mcp

# Codex CLI (OpenAI)
codex mcp add mineru --env MINERU_API_KEY=your-api-key -- npx -y mineru-mcp

# Gemini CLI (Google)
gemini mcp add -e MINERU_API_KEY=your-api-key mineru npx -y mineru-mcp

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": ["-y", "mineru-mcp"],
      "env": {
        "MINERU_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code

.vscode/mcp.json（ワークスペース）に追加するか、コマンドパレットを開き MCP: Open User Configuration（グローバル）を選択します。

{
  "servers": {
    "mineru": {
      "command": "npx",
      "args": ["-y", "mineru-mcp"],
      "env": {
        "MINERU_API_KEY": "your-api-key"
      }
    }
  }
}

⚠️ 重要提示

VS Codeでは、トップレベルのキーとして "servers" を使用し、"mcpServers" ではありません。他のVS Codeフォーク（Trae、Void、PearAIなど）も通常この形式を使用します。

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に追加します。

{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": ["-y", "mineru-mcp"],
      "env": {
        "MINERU_API_KEY": "your-api-key"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json（Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json）に追加します。

{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": ["-y", "mineru-mcp"],
      "env": {
        "MINERU_API_KEY": "your-api-key"
      }
    }
  }
}

Cline

ClineパネルのMCPサーバーアイコンを開き、設定 > 高度なMCP設定を選択してから、以下を追加します。

{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": ["-y", "mineru-mcp"],
      "env": {
        "MINERU_API_KEY": "your-api-key"
      }
    }
  }
}

Cherry Studio

設定 > MCPサーバー > サーバーを追加で、タイプを STDIO、コマンドを npx、引数を -y mineru-mcp に設定し、環境変数 MINERU_API_KEY を追加します。または、JSON/コードモードで以下を貼り付けます。

{
  "mineru": {
    "name": "MinerU",
    "command": "npx",
    "args": ["-y", "mineru-mcp"],
    "env": {
      "MINERU_API_KEY": "your-api-key"
    },
    "isActive": true
  }
}

Witsy

設定 > MCPサーバーで、新しいサーバーを追加し、タイプを stdio、コマンドを npx、引数を -y mineru-mcp に設定し、環境変数 MINERU_API_KEY をAPIキーに設定します。

Codex CLI (TOML設定)

代わりに、~/.codex/config.toml を直接編集します。

[mcp_servers.mineru]
command = "npx"
args = ["-y", "mineru-mcp"]

[mcp_servers.mineru.env]
MINERU_API_KEY = "your-api-key"

Gemini CLI (JSON設定)

代わりに、~/.gemini/settings.json を直接編集します。

{
  "mcpServers": {
    "mineru": {
      "command": "npx",
      "args": ["-y", "mineru-mcp"],
      "env": {
        "MINERU_API_KEY": "your-api-key"
      }
    }
  }
}

Windows

Windowsでは、npx にシェルラッパーが必要です。"command": "npx" を以下に置き換えます。

{
  "command": "cmd",
  "args": ["/c", "npx", "-y", "mineru-mcp"],
  "env": {
    "MINERU_API_KEY": "your-api-key"
  }
}

WindowsのCLIツールでは、以下のようにします。

claude mcp add mineru-mcp -e MINERU_API_KEY=your-api-key -- cmd /c npx -y mineru-mcp
codex mcp add mineru --env MINERU_API_KEY=your-api-key -- cmd /c npx -y mineru-mcp

ChatGPT

ChatGPTはHTTPSを介したリモートMCPサーバーのみをサポートしており、このようなローカルのstdioサーバーは直接サポートされていません。HTTPトランスポートを使用したパブリックURLの背後にデプロイする必要があります。

⚙️ 設定

APIキーは mineru.net で取得できます。

💻 使用例

単一のURLを解析する

mineru_parse({
  url: "https://example.com/document.pdf",
  model: "vlm",        // オプション: "pipeline" (デフォルト) または "vlm" (90%精度)
  pages: "1-10,15",    // オプション: ページ範囲
  ocr: true,           // オプション: OCRを有効にする (パイプラインのみ)
  formula: true,       // オプション: 数式認識
  table: true,         // オプション: 表認識
  language: "en",      // オプション: 言語コード
  formats: ["html"]    // オプション: 追加のエクスポート形式
})

タスクの進捗状況を確認する

mineru_status({
  task_id: "abc-123",
  format: "concise"    // オプション: "concise" (デフォルト) または "detailed"
})

簡潔な出力: done | abc-123 | https://cdn-mineru.../result.zip

複数のURLを一括解析する

mineru_batch({
  urls: ["https://example.com/doc1.pdf", "https://example.com/doc2.pdf"],
  model: "vlm"
})

バッチの進捗状況を確認する

mineru_batch_status({
  batch_id: "batch-123",
  limit: 10,           // オプション: 最大結果数 (デフォルト: 10)
  offset: 0,           // オプション: 最初のN個の結果をスキップ
  format: "concise"    // オプション: "concise" または "detailed"
})

ローカルファイルをアップロードする

mineru_upload_batch({
  directory: "/path/to/pdfs",  // サポートされているファイルを含むディレクトリをスキャン
  // または
  files: ["/path/to/doc1.pdf", "/path/to/doc2.pdf"],  // 明示的なファイルリスト
  model: "vlm",        // オプション
  formula: true,       // オプション
  table: true,         // オプション
  language: "en",      // オプション
  formats: ["html"]    // オプション
})

追跡用の batch_id が返されます。各ファイルの元の名前は data_id を通じて保持されます（空白はアンダースコアに置き換えられます）。

結果をマークダウンとしてダウンロードする

mineru_download_results({
  batch_id: "batch-123",       // mineru_upload_batch または mineru_batch から取得
  output_dir: "/path/to/output",
  overwrite: false             // オプション: 既存のファイルを上書きする
})

出力ファイル名は data_id から派生します（例: my_paper_title.md）。元のファイル名の空白はアンダースコアに置き換えられます。

典型的なローカルファイルのワークフロー

mineru_upload_batch → mineru_batch_status (ポーリング) → mineru_download_results

📄 サポートされる形式

• PDF、DOC、DOCX、PPT、PPTX
• PNG、JPG、JPEG

📏 制限事項

• 単一ファイル: 最大200MB、最大600ページ
• 1日のクォータ: 高優先度で2000ページ
• バッチ: 1リクエストあたり最大200ファイル

📄 ライセンス

MIT

🔗 リンク

• MinerU — ドキュメント解析サービス
• MinerU GitHub — オープンソース版
• MCP Specification — モデルコンテキストプロトコル