# MinerU-Markdown-Converter

# MinerU Document to Markdown

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add beilin/mineru-markdown-converter

# Browse available tools
npx -y @smithery/cli@latest tool list beilin/mineru-markdown-converter

# Get full schema for a tool
npx -y @smithery/cli@latest tool get beilin/mineru-markdown-converter create_parse_task

# Call a tool
npx -y @smithery/cli@latest tool call beilin/mineru-markdown-converter create_parse_task '{}'
```

## Direct MCP Connection

Endpoint: `https://mineru-markdown-converter--beilin.run.tools`

**Optional config:**
- `x-mineru-api-key` (header) — Your MinerU API Key (obtain from https://mineru.net/apiManage/token)

## Tools (5)

- `create_parse_task` — Create a document parsing task on MinerU API. Purpose: Submit a document URL for async conversion. Returns task_id for …
- `get_task_status` — Check the status of a document parsing task. Purpose: Poll task progress and get download URL when done. Provide task_i…
- `download_result` — Get the download URL for a completed parsing result. After calling, download with curl to ./temp/ and unzip: curl -L -o…
- `convert_to_markdown` — One-step document conversion. Purpose: Submit URL, poll until done, return download link. Constraints: Supported format…
- `convert_pdf_to_markdown` — Alias for convert_to_markdown. Same one-step workflow for Supported formats: PDF, DOC, DOCX, PPT, PPTX, PNG, JPG, JPEG,…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get beilin/mineru-markdown-converter <tool-name>
```

## Prompts (2)

- `convert-document` (documentUrl) — Convert a document URL to Markdown. Call convert_to_markdown, then download with curl and unzip to ./temp/. Aligned wit…
- `check-conversion-status` (taskId) — Check conversion task status. When done, use download_result to get zip_url, then curl to download and unzip to ./temp/.