Reported issues for MinerU Open MCP
Pod holds 5 of 5 GitHub reports that passed its relevance review. This can include external user reports, maintainer-confirmed bugs, and concrete feature gaps. Treat them as evidence to inspect, not a count of distinct defects.
Back to MinerU Open MCP.
Most discussed
Skill description is too long for agent loaders
The mineru-document-extractor skill has a very long description in the SKILL.md frontmatter.
This causes compatibility issues with agent skill loaders:
- Codex does not load the skill into the available skills list.
- Claude Code reports
1 skill description shortenedwhile loading skills.
Please shorten the frontmatter description and keep the detailed feature explanation in the Markdown body.
Read the thread · 2026-05-14 · open · external user · 1 comment
如何在DeepSeek Harness Desktop里作为插件安装?
如何在DeepSeek Harness Desktop里作为插件安装? 在插件页面输入,会有如下提示
Read the thread · 2026-10-02 · open · external user · 0 comments
Cloud API task stays in pending (never running) from Singapore with a valid token and successful upload — region restriction or queue?
中文摘要: 在新加坡网络下,令牌有效、上传地址和文件上传都成功,但 2 页的测试 PDF 在 10 分钟内一直停在 pending,没有进入 running;桌面客户端里 23.5 MB 的 PDF 也一直停在「获取中」。想确认这是地域限制、队列/限流,还是账号层面的限制;如果有大陆网络的朋友能确认同一份文件是否几秒内就能处理,会很有帮助。
What happens
From a network in Singapore, with a valid API token (Precision API, https://mineru.net/api/v4), the whole flow works up to the point where the task should start processing, and then the task never starts:
Authorization: Bearer <token>is accepted (a request for a non-existent task is…
Read the thread · 2026-10-02 · open · external user · 0 comments
parse_documents never saves extracted images and silently strips zip_url, producing broken image links
Summary
parse_documents never writes the extracted images to disk, and silently strips zip_url from the response. The returned Markdown contains  references that all point to non-existent files, so every figure in a parsed document becomes a broken link. This also contradicts the README, which advertises the zip url and "extra output formats".
Environment
- Package:
mineru-open-mcpv1.0.22 (latest on PyPI, released 2026-09-22) - SDK:…
Read the thread · 2026-10-01 · open · external user · 0 comments
MCP parse_documents fails with 'Invalid port' error on all file types (local paths and URLs)
Bug Description
The parse_documents MCP tool fails with error Invalid port: ':1]' on every input — local Windows file paths, Unix-style paths, and HTTPS URLs all produce the same error.
Environment
- Package:
mineru-open-mcpv1.0.21 - Installation method:
uvx mineru-open-mcp(via PyPI) - Client host: Windows 10 x64
- MCP transport: stdio
Steps to Reproduce
Call parse_documents with any of these inputs — all fail identically:
- Local Windows path:…
Read the thread · 2026-06-25 · open · external user · 0 comments
Most recent
The remaining reports are on the project's issue tracker.