Mervext

mervext-mcp

Mervext 用の MCP サーバーです。ドキュメントを入力すると、AI エージェント （Claude、Claude Code、Codex、Cursor、Hermes、Gemini CLI など）向けに構造化 JSON を出力します。

デプロイ済みの Mervext エンジン（https://api.vstudiodigital.com）を薄くラップしています。 単独で動作し、エンジンのリポジトリに変更を加えず、状態を保持せず、シークレットも保存しません。

ホスト済みエンドポイント（稼働中）

https://mcp.vstudiodigital.com/mcp — Cloudflare Workers 上で稼働する、ステートレスなストリーミング可能 HTTP（ゼロまでスケールダウン）。ヘルスチェック：GET /healthz。

クライアント設定（HTTP とヘッダーに対応する 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	1 件のドキュメント（PDF／写真／テキスト）を、フィールドごとの信頼度を含む構造化 JSON に変換します。組み込みのスキーマ ID、または独自の schema_json を使用できます。
classify_document	フィールドを抽出せずに、ドキュメントの種類を検出します。
list_schemas	組み込みスキーマ（ID と各スキーマが抽出する内容）を一覧表示します。
check_balance	プラン、残りクレジット、使用状況を確認します。
delete_document	ドキュメント ID を指定して、明示的に保持ゼロで削除します。

認証

MCP クライアントが Mervext API キーを提供します。サーバーにキーが保存されることはありません。

• stdio：MERVEKT_API_KEY=fw_live_…
• HTTP：リクエストごとに X-API-Key: fw_… または Authorization: Bearer fw_… ヘッダーを指定

ローカルで実行

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/*（ゾーンは 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 — 5 つのツール、ステートレス HTTP と stdio に対応し、稼働中のエンジンでテスト済み
• Cloudflare Workers にホスト済み — mcp.vstudiodigital.com で稼働中。 ホストされたスタックを通じたエンドツーエンドの動作を確認済み：テキスト形式の請求書は2.1 秒 （信頼度 1.0、ソースに基づく）。テキストレイヤーのないスキャン済み領収書 （ビジョン経路）は 7.6 秒。生画像に対して、有効なスキーマ名を示す明確な 422 を返します。
• 公式 MCP レジストリ：com.vstudiodigital/mervext（DNS 検証済みの公開元）
• /.well-known/mcp/server-card.json に静的サーバーカードを設置（レジストリ／スキャン用メタデータ）
• Smithery：contact-3yen/mervext — 公開済み
• mcp.so / Glama（公開リポジトリの掲載）

ライセンス

MIT — LICENSE を参照してください。

Mervext 製品リポジトリには意図的に含めていません。製品リポジトリでは独自のデプロイパイプラインを実行しています。