ParseRelay

@parserelay/mcp

ParseRelay の scan 操作を MCP ツールとして提供します。これにより、どの MCP ホスト（Claude Desktop、Cursor、…）からでも、ドキュメントを構造化された信頼度スコア付きのフィールドに解析できます。REST API および <DeadSimpleMicroScanner> コンポーネントと同じ契約で、ツールは scan の 1 つだけです。

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	テスト用にローカルワーカーを指定します。
PORT	いいえ	8080	HTTP トランスポートのみ。