ParseRelay

Name: ParseRelay
Author: parserelay

本地服务

parserelay.app生产力019 周前更新

代码仓库访问官网

关于 ParseRelay

ParseRelay 提供单个 MCP `scan` 工具，可将文档转换为带字段置信度评分的结构化数据，适用于需要同步解析文档的 MCP 宿主，并可通过试运行预览付费补救所需额度。

主要功能

01从文档图像提取结构化字段
02逐字段置信度与复核标记
03可选模式、文档类型和引擎
04试运行估算付费补救额度

适用场景

01从文档图像提取字段
02检查哪些解析字段需要复核
03付费扫描前估算额度

MCP 相关

向 MCP 宿主提供一个同步 `scan` 工具。结果包含字段、置信度、复核状态、来源和元数据，并支持 stdio 与 streamable HTTP 传输。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "parserelay": {
      "command": "npx",
      "args": [
        "-y",
        "@parserelay/mcp"
      ],
      "env": {
        "PARSERELAY_API_KEY": "<PARSERELAY_API_KEY>",
        "PARSERELAY_BASE_URL": "<PARSERELAY_BASE_URL>"
      }
    }
  }
}

启动命令npx -y @parserelay/mcp

需要配置的环境变量

PARSERELAY_API_KEY密钥ParseRelay API key (prl_live_…). Required for stdio.

PARSERELAY_BASE_URLAPI base URL. Defaults to https://api.parserelay.app; point at a local worker for testing.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@parserelay/mcp0.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
ocr	any	否	OCR 后端选择。使用后端 `passthrough` 并提供 `text` 可跳过 OCR。
image	string	是	要扫描的文档：HTTPS URL 或 base64 数据 URI（data:image/...;base64,...）。
model	string\|null	否	指定特定模型，例如 "claude-haiku-4-5"。
engine	enum	否	提取模式。默认为 `auto`（优先使用确定性方法，仅对标记的字段使用 LLM 补救）。auto \| ocr \| ocr+rescue \| ocr+check \| vision
schema	any	否	要提取的内容，以下两种形式之一：字段名称数组，或带有 `properties` 映射的 JSON Schema 对象。不要传入扁平的 {"field":"type"} 对象。通用文档可省略。
dry_run	boolean	否	仅预览：返回哪些字段将触发付费补救及预计额度，不会消耗额度。
doc_type	enum	否	可选的文档类型提示。receipt \| invoice \| id \| business_card \| freeform
model_key	string\|null	否	使用你自己的服务提供商密钥——你只需支付管道费用；模型费用由你的密钥承担。

详细介绍

@parserelay/mcp

将 ParseRelay 的 scan 操作作为一个 MCP 工具，让任何 MCP 宿主（Claude Desktop、Cursor、……）都能将文档解析为结构化、带置信度评分的字段。与 REST API 和 <DeadSimpleMicroScanner> 组件采用相同的契约；只有一个工具： scan。

`scan` 工具

输入与同步 ScanRequest 一致——image（必填），以及 schema、doc_type、engine、ocr、dry_run、model、model_key。（省略了 relay Webhook：工具调用是同步的，因此会直接在响应中返回完整结果。）结果是完整的 ScanEnvelope JSON，包含 fields、各字段的 confidence、 needs_review、field_source 和 meta（引擎、积分、令牌）。

设置 dry_run: true 可预览哪些字段会触发付费修复，以及预估所需积分，而无需花费任何积分。

运行

stdio（Claude Desktop、Cursor）

{
  "mcpServers": {
    "parserelay": {
      "command": "npx",
      "args": ["-y", "@parserelay/mcp"],
      "env": {
        "PARSERELAY_API_KEY": "your-key",
        "PARSERELAY_BASE_URL": "https://api.parserelay.app" // optional
      }
    }
  }
}

streamable-HTTP（远程／托管）

PARSERELAY_API_KEY=your-key PORT=8080 node node_modules/@parserelay/mcp/dist/http.js
# → POST http://localhost:8080/mcp

无状态：每个请求都会启动一个全新的服务，因此可以水平扩展。每个请求通过 Authorization: Bearer <key> 进行身份验证；对于单租户配置，则回退使用 PARSERELAY_API_KEY。

编程方式

import { createMcpServer } from "@parserelay/mcp";
import { ParseRelayClient } from "@parserelay/client";

const server = createMcpServer(new ParseRelayClient({ apiKey }));
// then wire your own transport: await server.connect(transport)

配置

环境变量	必填	默认值	说明
`PARSERELAY_API_KEY`	stdio：是	—	HTTP 可通过每个请求中的 `Authorization: Bearer` 覆盖。
`PARSERELAY_BASE_URL`	否	`https://api.parserelay.app`	指向本地 worker 进行测试。
`PORT`	否	`8080`	仅用于 HTTP 传输。