{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_5kwsmhjn9x2m","handle":"zh-ocr-mcp","url":"https://wellknown.network/agents/zh-ocr-mcp","links":{"self":"https://wellknown.network/agents/zh-ocr-mcp/record.json","html":"https://wellknown.network/agents/zh-ocr-mcp","markdown":"https://wellknown.network/agents/zh-ocr-mcp/record.md","api":"https://wellknown.network/api/v1/agents/zh-ocr-mcp","status":"https://wellknown.network/api/v1/agents/zh-ocr-mcp/status","claim":"https://wellknown.network/agents/zh-ocr-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/zh-ocr-mcp/claim.json","badge":"https://wellknown.network/agents/zh-ocr-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:zh-ocr-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"zh-ocr-mcp","summary":"ZH OCR MCP server for document to Markdown conversion","description":"# ZH OCR MCP-Server\n\n## 1. 概述\n\n这个项目提供了一个 **ZH OCR MCP 服务器** (`zh-ocr-mcp`)，它基于 **FastMCP** 框架构建。其主要功能是作为 **MinerU API** 的接口，用于将文档转换为 Markdown格式。\n\n该服务器通过 MCP 协议公开了以下主要工具：\n\n1. `parse_documents`：统一接口，支持处理本地文件和URL，自动根据配置选择最合适的处理方式，并自动读取转换后的内容\n2. `get_ocr_languages`：获取OCR支持的语言列表\n\n这使得其他应用程序或 MCP 客户端能够轻松地集成 MinerU 的 文档 到 Markdown 转换功能。\n\n## 2. 核心功能\n\n* **文档提取**: 接收文档文件输入（单个或多个 URL、单个或多个本地路径，支持doc、ppt、pdf、图片多种格式），调用 MinerU API 进行内容提取和格式转换，最终生成 Markdown 文件。\n* **批量处理**: 支持同时处理多个文档文件（通过提供由空格、逗号或换行符分隔的 URL 列表或本地文件路径列表）。\n* **OCR 支持**: 可选启用 OCR 功能（默认不开启），以处理扫描版或图片型文档。\n* **多语言支持**: 支持多种语言的识别，可以自动检测文档语言或手动指定。\n* **自动化流程**: 自动处理与 MinerU API 的交互，包括任务提交、状态轮询、结果下载解压、结果文件读取。\n* **本地解析**: 支持调用本地部署的mineru模型直接解析文档，不依赖远程 API，适用于隐私敏感场景或离线环境。\n* **智能路径处理**: 自动识别URL和本地文件路径，根据USE_LOCAL_API配置选择最合适的处理方式。\n\n## 3. 安装\n\n在开始安装之前，请确保您的系统满足以下基本要求：\n* Python >= 3.10\n\n### 3.1 使用 pip 安装 (推荐)\n\n如果你的包已发布到 PyPI 或其他 Python 包索引，可以直接使用 pip 安装：\n\n```bash\npip install zh-ocr-mcp==1.0.0\n```\n\n目前版本：1.0.0\n\n这种方式适用于不需要修改源代码的普通用户。\n\n### 3.2 从源码安装\n\n如果你需要修改源代码或进行开发，可以从源码安装。\n\n克隆仓库并进入项目目录：\n\n```bash\ngit clone <repository-url> # 替换为你的仓库 URL\ncd zh-ocr-mcp\n```\n\n推荐使用 `uv` 或 `pip` 配合虚拟环境进行安装：\n\n**使用 uv (推荐):**\n\n```bash\n# 安装 uv (如果尚未安装)\n# pip install uv\n\n# 创建并激活虚拟环境\nuv venv\n\n# Linux/macOS\nsource .venv/bin/activate \n# Windows\n# .venv\\\\Scripts\\\\activate\n\n# 安装依赖和项目\nuv pip install -e .\n```\n\n**使用 pip:**\n\n```bash\n# 创建并激活虚拟环境\npython -m venv .venv\n\n# Linux/macOS\nsource .venv/bin/activate \n# Windows\n# .venv\\\\Scripts\\\\activate\n\n# 安装依赖和项目\npip install -e .\n```\n\n## 4. 环境变量配置\n\n本项目支持通过环境变量进行配置。你可以选择直接设置系统环境变量，或者在项目根目录创建 `.env` 文件（参考 `.env.example` 模板）。\n\n### 4.1 支持的环境变量\n\n| 环境变量                  | 说明                                                            | 默认值                    |\n| ------------------------- | --------------------------------------------------------------- | ------------------------- |\n| `MINERU_API_BASE`       | MinerU 远程 API 的基础 URL                                      | `https://mineru.net`    |\n| `MINERU_API_KEY`        | MinerU API 密…","publisher":{"name":"zh-ocr-mcp maintainers","url":null},"homepage":null,"repository":null,"version":"1.0.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:zh-ocr-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"documents.ocr","name":"OCR","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.791,"provenance":"derived"}],"categories":["dev","documents"],"language":"zh"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"zh-ocr-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:36.186Z","publishedAt":"2026-07-16T01:13:24.323432Z","latestVersion":"1.0.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"zh-ocr-mcp","url":"https://pypi.org/project/zh-ocr-mcp/","firstSeenAt":"2026-09-10T16:23:55.199Z","fetchedAt":"2026-09-10T16:23:55.199Z","normalizedAt":"2026-09-10T16:23:55.199Z"}]},"firstSeenAt":"2026-09-10T16:23:55.199Z","updatedAt":"2026-09-10T16:24:36.186Z"}