Mineru Document Parsing Server integrates with the Mineru API to extract structured content from documents with support for OCR, formula recognition, and table detection. Key features: - Single and batch document processing via URL or local file upload - Multi-format support including PDF, DOC/DOCX, PPT/PPTX, and image files (PNG, JPG, JPEG) - OCR text recognition for scanned documents and images - Mathematical formula recognition and table structure extraction - Multi-language document processing including Chinese and English - Real-time task status monitoring for tracking parsing progress - Optional export to additional formats including DOCX, HTML, and LaTeX

Mineru MCP Server

A Model Context Protocol (MCP) document parsing server that integrates with Mineru API to provide powerful document parsing capabilities.

Features

Installation

npm install

Configuration

Before using, you need to configure the Mineru API key:

const config = {
  mineruApiKey: "your-mineru-api-bearer-token", // Mineru API Bearer token
  mineruBaseUrl: "https://mineru.net/api/v4" // Mineru API base URL
};

Available Tools

1. create_parsing_task

Parameters:

2. get_task_status

Parameters:

3. create_batch_parsing_task

Parameters:

4. create_batch_url_parsing_task

Parameters:

5. get_batch_task_results

Parameters:

Usage Examples

Single File Parsing

// Create parsing task
const taskResult = await create_parsing_task({
  url: "https://example.com/document.pdf",
  is_ocr: true,
  enable_formula: true,
  language: "en"
});
// Query task status
const status = await get_task_status({
  task_id: taskResult.task_id
});

Batch File Upload Parsing

// Create batch upload task
const batchResult = await create_batch_parsing_task({
  files: [
    { name: "document1.pdf", is_ocr: true },
    { name: "document2.docx" }
  ],
  enable_formula: true,
  language: "ch"
});
// Query batch task results (applicable to both batch parsing methods)
const batchStatus = await get_batch_task_results({
  batch_id: batchResult.batch_id
});

Batch URL Parsing

// Create batch URL parsing task
const batchUrlResult = await create_batch_url_parsing_task({
  files: [
    { url: "https://example.com/doc1.pdf", is_ocr: true },
    { url: "https://example.com/doc2.docx" }
  ],
  enable_formula: true,
  language: "en"
});
// Query batch task results (applicable to both batch parsing methods)
const batchUrlStatus = await get_batch_task_results({
  batch_id: batchUrlResult.batch_id
});

Development

npm run dev

Important Notes

1. Single file size cannot exceed 200MB, page count cannot exceed 600 pages 2. Each account has 2000 pages of highest priority parsing quota per day 3. Due to network restrictions, foreign URLs like GitHub and AWS may timeout 4. Batch upload file links are valid for 24 hours 5. No need to set Content-Type header when uploading files

Common Error Codes

| Error Code | Description | Solution | |------------|-------------|----------| | A0202 | Token error | Check if the Token is correct, or replace with a new Token | | A0211 | Token expired | Replace with a new Token | | -500 | Parameter error | Ensure parameter types and Content-Type are correct | | -10001 | Service exception | Please try again later | | -10002 | Request parameter error | Check request parameter format | | -6000