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 6 tools: mineru_parse, mineru_status, mineru_batch, mineru_batch_status, mineru_upload_batch and 1 more. 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 4 days ago. It has 7 GitHub stars.

Mineru MCP Server

mineru-mcp

MinerU document parsing API — PDFs, images, DOCX, PPTX with OCR and batch processing.

7 467/wk 6 tools GitHub npm

No known CVEs

No license

Actively maintained

Last commit 4d ago

Works with most clients

Transport: stdio, http

6 tools · ~822 tok

Grade B · 0.4% of 200K ctx

Edit this pageView history

Writing Data

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": {
        "MINERU_API_KEY": "your-api-key"
      },
      "args": [
        "-y",
        "mineru-mcp"
      ],
      "command": "npx"
    }
  }
}

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/io-github-linxule-mineru)](https://mcppedia.org/s/io-github-linxule-mineru)

Read me

What Mineru MCP Server does

MCP server for MinerU document parsing API — extract text, tables, and formulas from PDFs, DOCs, and images.

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.

npx -y 'mineru-mcp' 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

80/100across 5 weighted dimensions

How we score →

0255075100

−20

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked mineru-mcp against OSV.dev.

Inventory

Tools (6)

Click any tool to inspect its schema.

~822 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 6 tools: mineru_parse, mineru_status, mineru_batch, mineru_batch_status, mineru_upload_batch and 1 more. 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 4 days ago. It has 7 GitHub stars.

Similar servers

Others in writing / data

View all →

Dbhub96

Zero-dependency, token-efficient database MCP server for Postgres, MySQL, SQL Server, MariaDB, SQLite.

3.0k 2

Mysql_mcp_server95

A Model Context Protocol (MCP) server that enables secure interaction with MySQL databases

1.3k 2

Firecrawl Mcp Server95

🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.

6.7k 4

Supabase MCP Server95

Manage Supabase projects — databases, auth, storage, and edge functions

2.8k 4

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

Writing Data

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": {
        "MINERU_API_KEY": "your-api-key"
      },
      "args": [
        "-y",
        "mineru-mcp"
      ],
      "command": "npx"
    }
  }
}

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/io-github-linxule-mineru)](https://mcppedia.org/s/io-github-linxule-mineru)

Read me

What Mineru MCP Server does

MCP server for MinerU document parsing API — extract text, tables, and formulas from PDFs, DOCs, and images.

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.

npx -y 'mineru-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

mineru-mcp

MCP server for MinerU document parsing API — extract text, tables, and formulas from PDFs, DOCs, and images.

Features

VLM model — 90%+ accuracy for complex documents
Pipeline model — Fast processing for simple documents
Local file upload — Upload files from disk for batch parsing
Batch processing — Parse up to 200 documents at once
Download & rename — Extract markdown with original filenames
Page ranges — Extract specific pages only
109 language OCR support
Optimized for Claude Code — 73% token reduction vs alternatives

Tools

Tool	Description
`mineru_parse`	Parse a document URL
`mineru_status`	Check task progress, get download URL
`mineru_batch`	Parse multiple URLs (max 200)
`mineru_batch_status`	Get batch results with pagination
`mineru_upload_batch`	Upload local files for batch parsing
`mineru_download_results`	Download results as named markdown files

Installation

Requires Node.js 18+ and a MinerU API key.

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

Add to your claude_desktop_config.json:

OS	Config path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

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

VS Code

Add to .vscode/mcp.json (workspace) or open Command Palette > MCP: Open User Configuration (global):

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

Note: VS Code uses "servers" as the top-level key, not "mcpServers". Other VS Code forks (Trae, Void, PearAI, etc.) typically use this same format.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

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

Windsurf

Add to ~/.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

Open MCP Servers icon in Cline panel > Configure > Advanced MCP Settings, then add:

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

Cherry Studio

In Settings > MCP Servers > Add Server, set Type to STDIO, Command to npx, Args to -y mineru-mcp, and add environment variable MINERU_API_KEY. Or paste in JSON/Code mode:

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

Witsy

In Settings > MCP Servers, add a new server with Type: stdio, Command: npx, Args: -y mineru-mcp, and set environment variable MINERU_API_KEY to your API key.

Codex CLI (TOML config)

Alternatively, edit ~/.codex/config.toml directly:

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

[mcp_servers

... [View full README on GitHub](https://github.com/linxule/mineru-mcp#readme)

Loading README…

Scored, not listed

Why this score

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

Score breakdown

80/100across 5 weighted dimensions

How we score →

0255075100

−20

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked mineru-mcp against OSV.dev.

Inventory

Tools (6)

Click any tool to inspect its schema.

~822 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 6 tools: mineru_parse, mineru_status, mineru_batch, mineru_batch_status, mineru_upload_batch and 1 more. 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 4 days ago. It has 7 GitHub stars.