paddle-ocr-server 0.2.0

MCP server for PaddleOCR PDF-to-Markdown conversion

PaddleOCR MCP Server

通过 PaddleOCR 官方 API 将 PDF 或图片转换为 Markdown。

功能

• Tools: ocr_pdf — 提交 PDF/图片到 PaddleOCR，返回合并后的 Markdown 文件路径

环境要求

• Python >= 3.13
• uv

环境变量

变量	必需	说明
PADDLEOCR_ACCESS_TOKEN	✅	AI Studio access token，从 https://aistudio.baidu.com/account/accessToken 获取

安装

cd servers/paddle-ocr
uv sync

运行

PADDLEOCR_ACCESS_TOKEN=your-token uv run python server.py

测试

uv run pytest -v

接入 MCP Host

发布到 PyPI 后可用 uvx：

{
    "mcpServers": {
        "paddle-ocr": {
            "command": "uvx",
            "args": ["paddle-ocr-server"],
            "env": {
                "PADDLEOCR_ACCESS_TOKEN": "your-token"
            }
        }
    }
}

本地开发时用 uv：

{
    "mcpServers": {
        "paddle-ocr": {
            "command": "uv",
            "args": ["--directory", "/path/to/servers/paddle-ocr", "run", "paddle-ocr-server"],
            "env": {
                "PADDLEOCR_ACCESS_TOKEN": "your-token"
            }
        }
    }
}

## 使用方式

调用 `ocr_pdf` tool，提供 `file_path`（本地文件）或 `file_url`（URL），二选一。

结果保存到当前工作目录下的同名文件夹，结构如下：
- `full.md` — 合并所有页面的 Markdown
- `pages/page_N.md` — 每页单独的 Markdown
- `imgs/` — 图片文件

返回值为 `full.md` 的绝对路径。