Metadata-Version: 2.4
Name: paddle-ocr-server
Version: 0.2.1
Summary: MCP server for PaddleOCR PDF-to-Markdown conversion
Requires-Python: >=3.13
Requires-Dist: fastmcp>=3.4.2
Requires-Dist: httpx>=0.28.0
Description-Content-Type: text/markdown

# PaddleOCR MCP Server

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

## 功能

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

## 环境要求

- Python >= 3.13
- [uv](https://docs.astral.sh/uv/)

## 环境变量

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

## 安装

```bash
cd servers/paddle-ocr
uv sync
```

## 运行

```bash
PADDLEOCR_ACCESS_TOKEN=your-token uv run python server.py
```

## 测试

```bash
uv run pytest -v
```

## 接入 MCP Host

发布到 PyPI 后可用 `uvx`：

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

本地开发时用 `uv`：

```json
{
    "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` 的绝对路径。