Mervext

Name: Mervext
Author: vstudiodigital.com

远程服务

mervext.com生产力03 周前更新

代码仓库访问官网

关于 Mervext

mervext-mcp 是无状态 MCP 服务，可将文档发送给 Mervext 并接收结构化 JSON。它面向处理发票、收据和合同等文档的 Agent，并为提取字段提供置信度。

主要功能

01从 PDF、照片或文本提取结构化字段
02报告每个提取字段的置信度
03无需提取字段即可分类文档
04列出内置提取模式
05查询余额并删除文档

适用场景

01将发票字段提取为 JSON
02处理收据照片和扫描文档
03在提取字段前分类文档

MCP 相关

该服务提供文档提取、分类、模式列表、余额查询和文档删除五种工具。支持无状态 Streamable HTTP 和 stdio；MCP 客户端按请求提供 API 密钥。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.vstudiodigital.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-vstudiodigital-mervext https://mcp.vstudiodigital.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-vstudiodigital-mervext":{"type":"http","url":"https://mcp.vstudiodigital.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-vstudiodigital-mervext":{"type":"http","url":"https://mcp.vstudiodigital.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-vstudiodigital-mervext":{"type":"http","url":"https://mcp.vstudiodigital.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-vstudiodigital-mervext":{"serverUrl":"https://mcp.vstudiodigital.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

mervext-mcp

面向 Mervext 的 MCP 服务 — 输入文档，输出结构化 JSON，供 AI Agent （Claude、Claude Code、Codex、Cursor、Hermes、Gemini CLI，……）使用。

这是部署版 Mervext 引擎（https://api.vstudiodigital.com）的轻量封装。独立运行：无需修改引擎仓库，不保存状态或密钥。

托管端点（在线）

https://mcp.vstudiodigital.com/mcp — Streamable HTTP，无状态，运行于 Cloudflare Workers（按需扩缩至零）。健康检查：GET /healthz。

客户端配置（适用于支持 HTTP + headers 的任何 MCP 客户端）：

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

API 密钥由客户端在每次请求中提供 — Worker 不存储任何内容，不保留会话，也不持有密钥。可在 https://mervext.com 获取包含免费试用额度的密钥，或创建设备密钥：POST /v1/keys/device。

工具

工具	功能
`extract_document`	处理单份文档（PDF / 照片 / 文本）→ 输出带有各字段置信度的结构化 JSON。可使用内置 schema id 或自定义 `schema_json`。
`classify_document`	检测文档类型，不提取字段。
`list_schemas`	列出内置 schema（id 及各自提取的内容）。
`check_balance`	查看套餐、剩余额度和用量。
`delete_document`	根据文档 id 显式删除，确保零保留。

身份验证

MCP 客户端提供 Mervext API 密钥；服务端绝不存储该密钥：

stdio：MERVEKT_API_KEY=fw_live_…
HTTP：每次请求通过 X-API-Key: fw_… 或 Authorization: Bearer fw_… header 传递

本地运行

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

引擎基础 URL 覆盖变量：MERVEKT_API_URL（默认值为 https://api.vstudiodigital.com）。

部署（Cloudflare Workers）

npx wrangler deploy

wrangler.toml：Worker mervext-mcp，路由 mcp.vstudiodigital.com/*（zone vstudiodigital.com）。workers_dev 已关闭 — 仅使用路由（账号上没有 workers.dev 子域名）。
在 WSL 中运行 — wrangler OAuth 在 WSL 中运行（技能：cloudflare-pages-deploys）。

冒烟测试

# 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]

状态

v0 — 五种工具，无状态 HTTP + stdio，已通过在线引擎测试
已托管于 Cloudflare Workers — 在线地址为 mcp.vstudiodigital.com，已通过托管堆栈完成端到端验证：文本发票 2.1 s （置信度 1.0，依据来源）；无文本层的扫描收据（视觉处理路径）7.6 s；针对原始图像返回明确的 422 错误并列出有效 schema。
官方 MCP 注册表：com.vstudiodigital/mervext（已通过 DNS 验证的发布者）
/.well-known/mcp/server-card.json 上的静态服务卡片（供注册表/扫描使用的元数据）
Smithery：contact-3yen/mervext — 已发布
mcp.so / Glama（公开仓库列表）