Is Mineru Mcp Server safe to use?

Mineru Mcp Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install Mineru Mcp Server?

Mineru Mcp Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Mineru Mcp Server do?

Mineru Mcp Server provides 2 tools: get_token_status, pipeline. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Mineru Mcp Server?

Mineru Mcp Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.

Is Mineru Mcp Server actively maintained?

Mineru Mcp Server is actively maintained — last commit was 13 days ago. It has 11 GitHub stars.

Mineru Mcp Server

Name: Mineru Mcp Server
Author: neosun100

niquests · by neosun100

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

11 2 tools GitHub PyPI

No known CVEs

No license

Actively maintained

Last commit 13d ago

Works with most clients

Transport: stdio, http

2 tools · ~66 tok

Grade A · 0.0% of 200K ctx

Edit this pageView history

Productivity

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/mineru-mcp-server)](https://mcppedia.org/s/mineru-mcp-server)

Read me

What Mineru Mcp Server does

精准 API + Agent 轻量 API · 全参数透传 · 智能错误重试 · 自动拆分合并 · Token 自动续期

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'niquests' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

85/100across 5 weighted dimensions

How we score →

0255075100

−15

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked niquests against OSV.dev.

Inventory

Tools (2)

Click any tool to inspect its schema.

~66 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Mineru Mcp Server safe to use?: Mineru Mcp Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install Mineru Mcp Server?: Mineru Mcp Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Mineru Mcp Server do?: Mineru Mcp Server provides 2 tools: get_token_status, pipeline. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Mineru Mcp Server?: Mineru Mcp Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is Mineru Mcp Server actively maintained?: Mineru Mcp Server is actively maintained — last commit was 13 days ago. It has 11 GitHub stars.

Similar servers

Others in productivity

View all →

Memory MCP Server98

Persistent memory using a knowledge graph

86.4k 5

Sequential Thinking MCP Server98

Dynamic problem-solving through sequential thought chains

86.4k 1

Qmd95

mini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local

25.8k 4

io.github.miroapp/mcp-server95

Official Miro MCP server - Supports context to code and creating diagrams, docs, and data tables.

111 7

MCP Security Weekly

Get CVE alerts and security updates for Mineru Mcp Server and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Productivity

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/mineru-mcp-server)](https://mcppedia.org/s/mineru-mcp-server)

Read me

What Mineru Mcp Server does

精准 API + Agent 轻量 API · 全参数透传 · 智能错误重试 · 自动拆分合并 · Token 自动续期

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'niquests' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

MinerU MCP Server

完整的 MinerU 文档处理解决方案 — v4.0.0 全面升级版

精准 API + Agent 轻量 API · 全参数透传 · 智能错误重试 · 自动拆分合并 · Token 自动续期

快速开始 • 架构 • 处理流程 • MCP 工具 • 文档

✨ v4.0.0 亮点（2026-05-16）

🚀 覆盖官方完整能力：精准 API（/api/v4/）+ Agent 轻量 API（/api/v1/agent/）双线
🔥 6 个 MCP 工具：process_document / process_directory / process_document_lite / query_task_status / renew_tokens / get_token_status
🛡️ 健壮性大幅升级：30+ 错误码分类、智能重试、Token 自动续期、URL 服务端直传（无需下载）
📐 服务端 200 页限制适配：自动拆分 180 页/片处理后合并；无缝处理 1000+ 页文档
🐛 修复严重 bug：图片引用路径错位（影响所有历史输出，v4.0.0 已彻底解决）
🧪 测试体系：30 unit + 31 integration + 24 regression + 2 e2e = 87 tests, 100% pass

详见 docs/CHANGELOG.md 和 docs/API_V4_REFERENCE.md。

🏗️ 架构

5 层 / 10 模块 / 6 个 MCP 工具 / 双 API 客户端 — 一图看懂：

层	模块	职责
① MCP 接入层	`mineru_mcp_server.py`	6 个 MCP 工具的 schema + 调度
② 协调编排层	`auto_split.py` / `mineru_batch_async.py` / `mineru_async.py` / `progress.py`	拆分→处理→合并的本地协调（无网）
③ API 客户端层	`MinerUAsyncClient` / `AgentAPIClient`	调 MinerU 服务端的两套 API
④ 基础设施	`api_errors.py` / `token_manager.py` / `path_fixer.py` / `split_large_file.py`	错误处理、Token 管理、路径修复、PDF 物理拆分
⑤ 外部依赖	MinerU 服务端 / `batch_login.py` / `all_tokens.json`	6 个账号配额 6000 页/天

🔄 处理流程

输入 → 验证 → 拆分判断 → 提交 → 错误处理 → 轮询 → 下载 → 合并 → Markdown 输出：

关键能力：

URL 优先服务端直传（不下载到本地），失败兜底走下载-上传
图片自动开 OCR，HTML 自动切 MinerU-HTML 模型，Office 自动切 pipeline
30+ 错误码分类：RETRYABLE / AUTH / QUOTA / PERMANENT，分别配重试策略
path_fixer 修复 v3.x 严重 bug：images/x.jpg → {stem}_images/x.jpg，593 张图片缺失 0

🔪 自动拆分协调流程

服务端硬限制 200 页 / 200 MB。超规格文件全自动拆分→并发处理→智能合并，对调用方完全透明：

真实案例：某 496 页 PDF → 自动拆 3 片（166+166+164）→ 3 片同时处理 → 合并为单 .md ~210 K 字符。总耗时 ~3 分钟（vs 串行单线程预估 ~9 分钟）。

🛠️ MCP 工具

6 个 MCP 工具 · 决策树：

#	工具	用途	关键参数
1	`process_document`	精准 API 单文件处理	11 参数（含 `language` / `is_ocr` / `page_ranges` / `extra_formats` / `data_id` 等）
2	`process_directory`	精准 API 批量并行	10 参数 + `max_workers`
3	`process_document_lite`	Agent 轻量 API（≤10MB / 20 页 / 免 Token）	6 参数
4	`query_task_status`	异步查询任务进度	`task_id`, `lite`
5	`get_token_status`	Token 状态报告	—
6	`renew_tokens`	触发 Token 自动续期	`force`, `headless`

完整参数参考：docs/API_V4_REFERENCE.md

📊 性能与实测

真实数据（5 个文档 1229 页混合 PDF 集合）

文件	页数	处理方式	MD 字符	图片
PDF-A	91	直接处理	48,117	23
PDF-B	143	直接处理	82,443	1
PDF-C	190	直接处理	243,271	519
PDF-D	309	自动拆 2 片	247,435	30
PDF-E	496	自动拆 3 片	209,471	0
合计	1,229	—	830,737	573

总耗时（含 OCR 全部 5 个文件）：约 10 分钟。

异步并发性能对比

场景	串行处理	v4 并发处理	提升
单文件	23 秒	23 秒	—
3 文件	149 秒	88 秒	1.7×
10 文件	300 秒	30 秒	10×

OCR 收益分布（A/B 实测）

PDF	异体字（无 OCR）	异体字（有 OCR）	OCR 收益
PDF

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

85/100across 5 weighted dimensions

How we score →

0255075100

−15

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked niquests against OSV.dev.

Inventory

Tools (2)

Click any tool to inspect its schema.

~66 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Mineru Mcp Server safe to use?: Mineru Mcp Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install Mineru Mcp Server?: Mineru Mcp Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Mineru Mcp Server do?: Mineru Mcp Server provides 2 tools: get_token_status, pipeline. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Mineru Mcp Server?: Mineru Mcp Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is Mineru Mcp Server actively maintained?: Mineru Mcp Server is actively maintained — last commit was 13 days ago. It has 11 GitHub stars.