# 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](/mcp/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 shortened` while loading skills.

Please shorten the frontmatter `description` and keep the detailed feature explanation in the Markdown body.

[Read the thread](https://github.com/opendatalab/MinerU-Ecosystem/issues/51) · 2026-05-14 · open · external user · 1 comment

### 如何在DeepSeek Harness Desktop里作为插件安装？

如何在DeepSeek Harness Desktop里作为插件安装？
在插件页面输入，会有如下提示

<img width="678" height="204" alt="Image" src="https://github.com/user-attachments/assets/e1558da9-b620-48f2-89f1-f9ad484e46b6" />

[Read the thread](https://github.com/opendatalab/MinerU-Ecosystem/issues/62) · 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:

1. `Authorization: Bearer <token>` is accepted (a request for a non-existent task is…

[Read the thread](https://github.com/opendatalab/MinerU-Ecosystem/issues/61) · 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 `![](images/<sha256>.jpg)` 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-mcp` v1.0.22 (latest on PyPI, released 2026-09-22)
- **SDK:**…

[Read the thread](https://github.com/opendatalab/MinerU-Ecosystem/issues/60) · 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-mcp` v1.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:

1. Local Windows path:…

[Read the thread](https://github.com/opendatalab/MinerU-Ecosystem/issues/53) · 2026-06-25 · open · external user · 0 comments

## Most recent

The remaining reports are on [the project's issue tracker](https://github.com/opendatalab/MinerU-Ecosystem/issues).