ParseRelay

السجل الرسمي الإنتاجية

Parse a document into structured, confidence-scored fields. Bring your own model, pay per scan.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @parserelay/mcp
Claude Code
claude mcp add parserelay -e 'PARSERELAY_API_KEY=<your parserelay_api_key>' -e 'PARSERELAY_BASE_URL=<PARSERELAY_BASE_URL>' -- npx -y @parserelay/mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "parserelay": {
            "command": "npx",
            "args": [
                "-y",
                "@parserelay/mcp@0.1.1"
            ],
            "env": {
                "PARSERELAY_API_KEY": "<your parserelay_api_key>",
                "PARSERELAY_BASE_URL": "<PARSERELAY_BASE_URL>"
            }
        }
    }
}

متغيرات البيئة

  • PARSERELAY_API_KEY إلزامي سري ParseRelay API key (prl_live_…). Required for stdio.
  • PARSERELAY_BASE_URL API base URL. Defaults to https://api.parserelay.app; point at a local worker for testing.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @parserelay/mcp
  2. The scan tool
  3. Run it
  4. Programmatic
  5. Config

@parserelay/mcp

ParseRelay's scan operation as an MCP tool — so any MCP host (Claude Desktop, Cursor, …) can parse a document into structured, confidence-scored fields. Same contract as the REST API and the <DeadSimpleMicroScanner> component; one tool, scan.

The scan tool

Input mirrors the sync ScanRequest — image (required), plus schema, doc_type, engine, ocr, dry_run, model, model_key. (relay webhooks are omitted: a tool call is synchronous, so you get the envelope back inline.) The result is the full ScanEnvelope as JSON: fields, per-field confidence, needs_review, field_source, and meta (engine, credits, tokens).

Set dry_run: true to preview which fields would trigger a paid rescue — and the estimated credits — without spending anything.

Run it

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 (remote / hosted)
PARSERELAY_API_KEY=your-key PORT=8080 node node_modules/@parserelay/mcp/dist/http.js
# → POST http://localhost:8080/mcp

Stateless: a fresh server per request, so it scales horizontally. Auth per request via Authorization: Bearer <key>, falling back to PARSERELAY_API_KEY for single-tenant setups.

Programmatic

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)

Config

Env varRequiredDefaultNotes
PARSERELAY_API_KEYstdio: yes—HTTP can override per request via Authorization: Bearer.
PARSERELAY_BASE_URLnohttps://api.parserelay.appPoint at a local worker for testing.
PORTno8080HTTP transport only.

الأسئلة الشائعة

ما هو ParseRelay؟

Parse a document into structured, confidence-scored fields. Bring your own model, pay per scan.

كيف أثبّت ParseRelay؟

يعمل على جهازك. في Claude Code: claude mcp add parserelay -e 'PARSERELAY_API_KEY=<your parserelay_api_key>' -e 'PARSERELAY_BASE_URL=<PARSERELAY_BASE_URL>' -- npx -y @parserelay/mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ParseRelay إلى مفتاح API؟

نعم. يتطلب PARSERELAY_API_KEY، وتضبطها في إعداداته.

هل ParseRelay مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون ParseRelay؟

ينشره parserelay. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.