paddle-ocr-server 0.2.2

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 paddle-ocr-server

测试

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 的绝对路径。