English Français العربية

Mervext

السجل الرسمي المالية والمدفوعات

Extract invoices, receipts and contracts into structured JSON. EU-hosted, per-field confidence.

الشيفرة المصدرية الموقع التوثيق

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mervext 'https://mcp.vstudiodigital.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mervext": {
            "type": "http",
            "url": "https://mcp.vstudiodigital.com/mcp"
        }
    }
}

التوثيق

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

المحتويات
  1. mervext-mcp
  2. Hosted endpoint (live)
  3. Tools
  4. Auth
  5. Run locally
  6. Deploy (Cloudflare Workers)
  7. Smoke tests
  8. Status
  9. License

mervext-mcp

MCP server for Mervext — documents in, structured JSON out, for AI agents (Claude, Claude Code, Codex, Cursor, Hermes, Gemini CLI, …).

Thin wrapper over the deployed Mervext engine (https://api.vstudiodigital.com). Standalone: no changes to the engine repo, no state, no stored secrets.

Hosted endpoint (live)

https://mcp.vstudiodigital.com/mcp — Streamable HTTP, stateless, on Cloudflare Workers (scale-to-zero). Health: GET /healthz.

Client config (any MCP client that supports HTTP + headers):

{
  "mcpServers": {
    "mervext": {
      "type": "http",
      "url": "https://mcp.vstudiodigital.com/mcp",
      "headers": { "X-API-Key": "fw_…your key…" }
    }
  }
}

The API key is supplied per request by the client — the worker stores nothing, keeps no sessions, and holds no secrets. Get a key with free trial credits at https://mervext.com, or mint a device key: POST /v1/keys/device.

Tools

ToolWhat it does
extract_documentOne document (PDF / photo / text) → structured JSON with per-field confidence. Built-in schema id or your own schema_json.
classify_documentDetect document type without extracting fields.
list_schemasThe built-in schemas (id + what each extracts).
check_balancePlan, remaining credits, usage.
delete_documentExplicit zero-retention delete by document id.

Auth

The MCP client supplies the Mervext API key; the server never stores it:

  • stdio: MERVEKT_API_KEY=fw_live_…
  • HTTP: X-API-Key: fw_… or Authorization: Bearer fw_… header per request

Run locally

npm install
npm run build

# stdio (local clients)
MERVEKT_API_KEY=fw_live_… node dist/stdio.js

# HTTP (local / testing)
node dist/http.js            # :8787 — POST /mcp, GET /healthz

Engine base URL override: MERVEKT_API_URL (default https://api.vstudiodigital.com).

Deploy (Cloudflare Workers)

npx wrangler deploy
  • wrangler.toml: worker mervext-mcp, route mcp.vstudiodigital.com/* (zone vstudiodigital.com). workers_dev is off — route only (no workers.dev subdomain on the account).
  • Run from WSL — wrangler OAuth lives there (skill: cloudflare-pages-deploys).

Smoke tests

# stdio, against the live engine (1–2 credits)
node scripts/mcp-smoke.ts [--image path.jpg] [--schema invoice]

# hosted worker, real Streamable-HTTP client
MERVEKT_API_KEY=… node scripts/mcp-http-smoke.ts [https://…/mcp]

Status

  • [x] v0 — five tools, stateless HTTP + stdio, tested against the live engine
  • [x] Hosted on Cloudflare Workers — live at mcp.vstudiodigital.com, verified end-to-end through the hosted stack: text invoice 2.1 s (confidence 1.0, source-grounded); scanned receipt without a text layer (vision path) 7.6 s; clean 422 naming valid schemas for raw images.
  • [x] Official MCP registry: com.vstudiodigital/mervext (DNS-verified publisher)
  • [x] Static server card at /.well-known/mcp/server-card.json (metadata for registries/scanning)
  • [x] Smithery: contact-3yen/mervext — published
  • [ ] mcp.so / Glama (public-repo listings)

License

MIT — see LICENSE.

Not in the Mervext product repo on purpose — that repo runs its own deploy pipeline.

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

ما هو Mervext؟

Extract invoices, receipts and contracts into structured JSON. EU-hosted, per-field confidence.

كيف أثبّت Mervext؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http mervext 'https://mcp.vstudiodigital.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

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

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

من يصون Mervext؟

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

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