linxule/mineru-mcp

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

10 stars 3 forks 品質 89 トレンド 32MIT

MCP server and mineru-cloud CLI for the MinerU document parsing API, with complete artifact retention, durable operations, and portable PDF bundles.

概要

MCP server and mineru-cloud CLI for the MinerU document parsing API, with complete artifact retention, durable operations, and portable PDF bundles. Durable operations and bundles in this checkout are unreleased. The published [email protected] does not include them; npm users need a release containing these changes. - — Document parsing with a vision-language model - — Document parsing with the pipeline model - — Upload files from disk for batch parsing - — Submit multiple documents in one request - — Extract markdown with original filenames - — Extract specific pages only - — mineru_parse_long submits page-range slices and mineru_merge_slices stitches - — mineru-cloud calls the same tools from a shell - — Select a language and enable OCR for the pipeline model Use Node.js 24 for new installations. Node.js 18+ remains supported for compatibility. Cloud commands require a MinerU API key; offline bundle creation requires no credentials.

README

以下は原文 README の抜粋です。原文を見る。

mineru-mcp

MCP server and mineru-cloud CLI for the MinerU document parsing API, with complete artifact retention, durable operations, and portable PDF bundles.

Durable operations and bundles in this checkout are unreleased. The published [email protected] does not include them; npm users need a release containing these changes.

Features

VLM model — Document parsing with a vision-language model
Pipeline model — Document parsing with the pipeline model
Local file upload — Upload files from disk for batch parsing
Batch processing — Submit multiple documents in one request
Download & rename — Extract markdown with original filenames
Page ranges — Extract specific pages only
Long documents — mineru_parse_long submits page-range slices and mineru_merge_slices stitches
CLI twin — mineru-cloud calls the same tools from a shell
Language and OCR options — Select a language and enable OCR for the pipeline model

Tools

Tool	Description
`mineru_parse`	Parse a document URL
`mineru_status`	Check task progress, get download URL
`mineru_batch`	Parse multiple URLs
`mineru_batch_status`	Get batch results with pagination
`mineru_upload_batch`	Upload local files for batch parsing
`mineru_download_results`	Retain complete archives, inventory all members, and create named compatibility copies
`mineru_parse_long`	Submit a long document as a batch of page-range slices
`mineru_merge_slices`	Join available Markdown and retain immutable slice archives with explicit unknown page provenance
`mineru_capabilities`	Read locally known capabilities; explicit refresh performs discovery
`mineru_submit`	Submit with a durable local journal and duplicate-request protection
`mineru_operation_status`	Read a recorded operation; explicit refresh checks remote status
`mineru_resume`	Continue safe recorded checkpoints
`mineru_cancel`	Stop local processing; remote cancellation is unsupported
`mineru_bundle`	Validate and return an operation’s retained bundle

Installation

Use Node.js 24 for new installations. Node.js 18+ remains supported for compatibility. Cloud commands require a MinerU API key; offline bundle creation requires no credentials.

Local output retention, bundles, and durable operations require macOS or Linux. These paths use directory-bound filesystem operations and fail closed on Windows; the Windows client configuration below does not imply local retention support.

CLI Install (one-liner)

# 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

GitHub で README 全文を見る

インストール

npx -y mineru-mcp

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

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