SCNet Document Parser (Python / stdio MCP)

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

特性

推荐流程：

upload_file(path) → file_url
submit_parse(file_url) → task_id
轮询 get_parse_task_status 直到 result_ready
get_parse_result(task_id, format="markdown", max_wait_seconds=0)

环境要求

• 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

或用路径直接 uvx：

SCNET_API_KEY=sk-xxx uvx --from /Users/haojie/workspace/project/mcp-document-parsing-py scnet-document-parser

2）发布到 PyPI 之后

# 用户侧只需：
uvx scnet-document-parser
# 或固定版本
uvx scnet-document-parser==0.1.0

uvx 会从 PyPI 拉包、建临时环境、执行入口脚本 scnet-document-parser。

MCP 客户端配置

Claude Code / Claude Desktop

{
  "mcpServers": {
    "scnet-document-parser": {
      "command": "uvx",
      "args": [
        "--from",
        "/Users/haojie/workspace/project/mcp-document-parsing-py",
        "scnet-document-parser"
      ],
      "env": {
        "SCNET_API_KEY": "sk-your-key"
      }
    }
  }
}

发布到 PyPI 后可简化为：

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

Cursor

在 MCP 设置中同样使用 command + args + env 即可（stdio 模式，不是 URL）。

可选环境变量

与 Java SSE 版对比

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

开发

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

发布到 PyPI（供他人 uvx）

# 构建
uv build

# 上传（需 PyPI token）
uv publish

# 验证
uvx scnet-document-parser --help   # 入口会启动 stdio；无 key 时会报错退出

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

支持的文件类型

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

大小上限可通过环境变量覆盖：SCNET_MAX_FILE_SIZE / SCNET_MAX_EXCEL_FILE_SIZE / SCNET_MAX_IMAGE_FILE_SIZE。