MCPgee
MCPgee
MCPgeeMCPgee

MinerU

v1.0.0•Search & Data Extraction•stable

MinerU MCP Server - 完整的文档处理解决方案。支持PDF/PPTX/DOCX/图片，真正异步并发，批量异步并行，MCP自然语言交互，性能提升10倍。

minerumcpai-integration
Share:
10
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is MinerU?

MinerU is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mineru mcp server - 完整的文档处理解决方案。支持pdf/pptx/docx/图片，真正异步并发，批量异步并行，mcp自然语言交互，性能提升10倍。

MinerU MCP Server - 完整的文档处理解决方案。支持PDF/PPTX/DOCX/图片，真正异步并发，批量异步并行，MCP自然语言交互，性能提升10倍。

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MinerU MCP Server - 完整的文档处理解决方案。支持PDF/PPTX/DOCX/图片，真正异步并发，批量

Use Cases

Process PDF, PPTX, DOCX, and image documents with 10x performance improvement.
Extract structured data from documents using asynchronous batch processing.
Automate document conversion and data extraction workflows.
neosun100

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 16, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx mineru

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MinerU

The MinerU MCP Server is a high-performance document processing solution that integrates MinerU's cloud API with MCP-compatible AI assistants. It supports PDF, PPTX, DOCX, and image files with true async concurrent processing, enabling batch parallel document extraction with up to 10x performance improvement over synchronous approaches. It exposes six MCP tools for document submission, status polling, and token management.

Prerequisites

  • Python 3.10 or higher installed
  • uv package manager installed
  • A MinerU cloud account (https://mineru.net) with API credentials
  • Playwright Chromium for headless login token acquisition
  • Claude Desktop or a compatible MCP client
1

Clone and install the server

Clone the repository and run the one-command installer, or perform the manual setup steps below.

git clone https://github.com/neosun100/mineru-mcp-server.git
cd mineru-mcp-server
./install_mcp.sh
2

Manual setup (if install script unavailable)

Create a virtual environment, install Python dependencies, and install the Chromium browser for headless login.

uv venv
source .venv/bin/activate
uv pip install -r requirements.txt
.venv/bin/playwright install chromium
3

Configure your MinerU accounts

Copy the example accounts configuration file and fill in your MinerU credentials. Multiple accounts can be added for load balancing.

cp config/accounts.yaml.example config/accounts.yaml
# Edit config/accounts.yaml with your email and password
4

Acquire API tokens via headless login

Run the batch login script to authenticate with MinerU and save tokens to all_tokens.json. This file is read by the MCP server at runtime.

.venv/bin/python3 src/batch_login.py
5

Add the server to your MCP client config

Register the MCP server in your Claude Desktop or Kiro settings file.

{
  "mcpServers": {
    "mineru": {
      "command": "/absolute/path/to/mineru-mcp-server/.venv/bin/python3",
      "args": ["/absolute/path/to/mineru-mcp-server/src/server.py"]
    }
  }
}

MinerU Examples

Client configuration

MCP client configuration pointing to the MinerU server's Python interpreter and server script.

{
  "mcpServers": {
    "mineru": {
      "command": "/Users/yourname/mineru-mcp-server/.venv/bin/python3",
      "args": ["/Users/yourname/mineru-mcp-server/src/server.py"]
    }
  }
}

Prompts to try

Example natural language prompts to use with the MinerU MCP server once configured.

- "Process ~/Documents/report.pdf and extract the text content"
- "Convert all PDF files in ~/Documents/invoices to structured data"
- "Check the status of my MinerU processing task with ID abc123"
- "Check my MinerU token status to see if tokens need renewal"
- "Process this PPTX presentation and extract all slide content"

Troubleshooting MinerU

batch_login.py fails with login error

Verify your email and password are correct in config/accounts.yaml. Ensure Chromium is installed by running .venv/bin/playwright install chromium. If MinerU has CAPTCHA on login, try running the script in non-headless mode by editing the headless flag in the script.

process_document returns token expired error

Tokens from MinerU expire periodically. Use the renew_tokens MCP tool to trigger automatic renewal, or re-run .venv/bin/python3 src/batch_login.py manually to refresh all_tokens.json.

Batch processing is slow or times out

Use process_directory instead of calling process_document in a loop — it runs parallel async workers. Adjust max_workers to match your account rate limits. Use query_task_status to poll for async task completion rather than waiting synchronously.

Frequently Asked Questions about MinerU

What is MinerU?

MinerU is a Model Context Protocol (MCP) server that mineru mcp server - 完整的文档处理解决方案。支持pdf/pptx/docx/图片，真正异步并发，批量异步并行，mcp自然语言交互，性能提升10倍。 It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MinerU?

Follow the installation instructions on the MinerU GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MinerU?

MinerU works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MinerU free to use?

Yes, MinerU is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

MinerU Alternatives — Similar Search & Data Extraction Servers

Looking for alternatives to MinerU? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.

TrendRadar

★ 58.0k

A real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va

Scrapling

★ 52.7k

🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!

PDF Math Translate

★ 33.9k

[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero

GPT Researcher

★ 27.2k

An autonomous agent that conducts deep research on any data using any LLM providers

Agent Reach

★ 20.1k

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

Xiaohongshu

★ 13.7k

MCP for xiaohongshu.com

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Search & Data ExtractionBrowse All Servers

Quick Config Preview

{ "mcpServers": { "mineru": { "command": "npx", "args": ["-y", "mineru"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MinerU?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides