SCNet Document Parser (Python / stdio MCP)

本地 stdio MCP 服务，封装 SCNet 文档 OCR 能力。
相对 Java SSE 版的关键差异：upload_file 接收本机文件路径，由进程直接读盘上传，不再把文件 base64 塞进工具参数。

定位：个人 Agent 的小文档高精度解析（公式 / 印章 / 表格等）。大文件请走 SCNet 或长文档 HTTP API。

特性

推荐流程（多步轮询，避免长时间阻塞）：

upload_file(path) → file_url
submit_parse(file_url, page_index?, is_table_cls?, ...) → task_id
轮询 get_parse_task_status 直到 result_ready
get_parse_result(task_id)                 # 默认 agent：markdown + capabilities + highlights
# 可选：format=markdown | blocks | full

submit_parse 请求体会固定带上 ocrType=DOC_PARING、source=mcp、channelTag=mcp（与 file_url 同级）。可选：

format 说明

环境要求

• Python 3.10+
• uv（推荐，用于 uvx 一键运行）
• SCNet API Key

用 uvx 运行（推荐）

1）本地开发（未发布到 PyPI 时）

cd /Users/haojie/workspace/project/mcp-document-parsing-py
uv sync
SCNET_API_KEY=sk-xxx uv run scnet-document-parser

2）发布到 PyPI 之后

uvx scnet-document-parser
# 或固定版本
uvx scnet-document-parser==0.4.0

MCP 客户端配置

Claude Code / Claude Desktop

{
  "mcpServers": {
    "scnet-document-parser": {
      "command": "uvx",
      "args": ["scnet-document-parser"],
      "env": {
        "SCNET_API_KEY": "sk-your-key"
      }
    }
  }
}

本地未发布时可将 args 改为：

"args": ["--from", "/path/to/mcp-document-parsing-py", "scnet-document-parser"]

可选环境变量

环境变量大于硬顶时会被 clamp 到硬顶 并打 warning。

支持的文件类型

与 ai-sugon-long-document-parsing 的 FileType / TaskController.submit 对齐：

超限会拒绝上传并提示走 HTTP API。

与 Java SSE 版对比

业务链路一致：presign → OSS multipart → submit → query → 下载结果 → agent/full/markdown/blocks。

开发

cd /Users/haojie/workspace/project/mcp-document-parsing-py
uv sync --group dev
uv run pytest

发布到 PyPI（供他人 uvx）

uv build
uv publish

包名：scnet-document-parser
控制台入口：scnet-document-parser → scnet_document_parser.server:main