RevClamp MCP Server

RevClamp MCP サーバー＆CLI（revclamp-mcp）

revclamp-mcp は、純粋な Node.js で 9 つの決定論的な B2B FinOps、Stripe 2025-03-31.basil、Visa CE 3.0、EU/XI VIES VAT、Shopify Plus B2B Net-15/30/60、および Webhook セキュリティツールを実装した、依存関係ゼロのスタンドアロン オープンソース Model Context Protocol（MCP）サーバー＆CLI（index.mjs ＋ local_engine.mjs）です。

• 100％ローカルのプロセス内実行（デフォルト — ネットワークアクセス不要、API キー不要）： 9 つすべての MCP ツール（initialize、tools/list、tools/call）は、純粋な Node.js（node:crypto による HMAC-SHA256 検証、整数セント単位の複式簿記、72 時間の webhook リプレイ状態マシン、18,000 UTF-16 コード単位の CE 3.0 lint 処理）を使用して、local_engine.mjs 内でローカルに実行されます。REVCLAMP_API_KEY または REVCLAMP_MCP_URL が明示的に設定されていない限り、ネットワーク呼び出しは一切行われません。
• 任意のホスト型クラウドワークスペース同期（REVCLAMP_API_KEY）： REVCLAMP_API_KEY（rg_live_...）が設定されている場合、revclamp-mcp は RevClamp Enterprise（https://api.revclamp.com/api/mcp）に接続し、90 日間の永続的なトランザクション利用状況・監査台帳、24 時間 365 日稼働する Stripe の異議申し立て・権限付与 webhook アウトボックス、および EU 委員会 VIES SOAP ゲートウェイのリアルタイム照会番号を利用できます。

ローカル Open-Core（local_engine.mjs）とホスト型クラウド（REVCLAMP_API_KEY）

機能	ローカル Open-Core のデフォルト（API キー不要）	ホスト型クラウド（REVCLAMP_API_KEY）
実行とネットワーク	100％プロセス内（local_engine.mjs）、ネットワーク呼び出しなし	https://api.revclamp.com/api/mcp への HTTPS JSON-RPC（redirect: "error"）
利用状況と監査の保存	呼び出し元が提供する JSON スナップショットをステートレスに評価	永続的な 90 日間のトランザクション台帳 ＋ Stripe の履歴バックフィル
異議申し立てと権限付与の処理	非破壊的な submit: false のドラフトと revoke_entitlement の判定を返します	24 時間 365 日稼働する Stripe webhook アウトボックス（disputes.update と署名付き権限取り消し webhook）
EU および XI の B2B VAT（VIES）	決定論的な構文チェックと GR -> EL の正規化（デフォルトは FORMAT_ONLY、valid: null）	EU 委員会 VIES SOAP のリアルタイム照会 ID ＋ サーキットブレーカー付き再試行キュー（viesMode: "LIVE" ＋ REVCLAMP_API_KEY）
月間イベントティア	ローカルのプロセス内評価は無制限（ネットワークコストなし）	無料サンドボックス（月 5,000 イベント） · Starter $19/月（100k） · Growth $59/月（1M） · Scale $199/月（5M）
データ最小化とプライバシー	お使いのマシンからデータが外部に送信されることはありません	ローカルで実際のシークレットをスクラブ処理した後、明示的な tools/call 引数のみを TLS 経由で送信します（ネットワークリクエストの前に sk_live_、テスト用でない whsec_、および shpat_ をローカルでブロック）

local_engine.mjs に実装されているオープンソースの MCP ツール（9 個）

ツール名	ドメイン	ローカルプロセス内実装（local_engine.mjs）	実行モード
revclamp_audit_revenue_leakage	Stripe Billing & Usage	呼び出し元が指定した顧客／使用状況の配列を評価し（合成サンプルでは demo: true）、ワークスペースの台帳が接続されていない場合はアップグレード用のフックを返します	ローカルプロセス内（または任意のクラウドキー）
revclamp_evaluate_ghost_usage	Stripe 2025-03-31.basil	複数サブスクリプションの顧客スナップショット（has_more: false を強制）と、未払いの API／LLM 利用超過に対する 0～14 日の督促猶予期間を評価します	ローカルプロセス内（または任意のクラウドキー）
revclamp_stage_stripe_dispute_ce3	Visa 10.4 / CE 3.0	呼び出し元が指定した usageEvents（サンプルでは demo: true）に対して、過去 120～365 日の未係争の請求（ip_subnet／device_id の重複）を評価し、非破壊的な submit: false の下書き（18,000 UTF-16 コード単位以下）を作成します	ローカルプロセス内（または任意のクラウドキー）
revclamp_validate_eu_vat_vies	EU および XI の B2B VAT	EU 加盟国 27 か国と北アイルランド（XI）の VAT ID を正規化し（GR -> EL）、構文をローカルで確認し（FORMAT_ONLY、valid: null）、errorWrappers をシミュレートするか（demo: true）、EU VIES にライブクエリを送信します（viesMode: "LIVE" + REVCLAMP_API_KEY）	ローカルプロセス内（または任意のライブ VIES）
revclamp_reconcile_b2b_net_terms	B2B 卸売の Net-30	整数の EUR セントを使った複式簿記で、Net-15／30／60 の前払い預金とクレジットノートを照合します	ローカルプロセス内（または任意のクラウドキー）
revclamp_verify_webhook_signature	Webhook HMAC-SHA256	300 秒のリプレイチェックを行い、未加工の UTF-8 バイト列（node:crypto）に対して Stripe-Signature、X-Shopify-Hmac-Sha256、X-RevClamp-Signature を生成・検証します	ローカルプロセス内（または任意のクラウドキー）
revclamp_calculate_roi_and_plan_fit	手数料率 0% の ROI とプラン適合性	チャージバック代行業者の 25%～30% と比較して、B2B の月次および年次の利益率削減額を整数の USD セントで算出し、最適なティアを推奨します	ローカルプロセス内（または任意のクラウドキー）
revclamp_simulate_webhook_replay	Webhook リプレイと FSM	72 時間の重複排除 Set と単調増加する createdSec ガードを使い、サブスクリプションのライフサイクル Webhook を、単純な到着順ハンドラーと比較してシミュレートします	ローカルプロセス内（または任意のクラウドキー）
revclamp_lint_dispute_evidence	紛争証拠の UTF-16 と CE 3.0	evidence[access_activity_log] ペイロードが、UTF-16 の 18,000 コード単位の上限、非破壊的な CE 3.0 マーカー、および加盟店メモの保持要件に適合しているかを lint します	ローカルプロセス内（または任意のクラウドキー）

クイックスタート（Claude Desktop / Cursor / Windsurf）

revclamp-mcp を claude_desktop_config.json または .cursor/mcp.json に追加します。デフォルトでは、revclamp-mcp は100% ローカルのプロセス内で実行され、ネットワーク呼び出しは一切なく、API キーも不要です。

{
  "mcpServers": {
    "revclamp": {
      "command": "npx",
      "args": ["-y", "github:lhphong09t2/revclamp-mcp"]
    }
  }
}

（任意）https://revclamp.com/dashboard のライブワークスペースに接続するには、REVCLAMP_API_KEY を env に渡すか、ホスト型の Streamable HTTP エンドポイント（POST https://api.revclamp.com/api/mcp）を使用します。

curl -sS -X POST https://api.revclamp.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

CLI の使用方法と <60s のローカルスモークチェック（--self-test）

# Run a <60s local CLI smoke check (verifies all 9 tool schemas & executes a local_engine.mjs sample audit with zero API key)
npx -y github:lhphong09t2/revclamp-mcp#v1.20.11 --self-test

# Provision a free Cloud Workspace (or reuse REVCLAMP_API_KEY) & send a 6-digit login OTP
npx -y [email protected] --init-workspace [email protected]

# Verify the 6-digit OTP using REVCLAMP_API_KEY from environment
REVCLAMP_API_KEY="rg_live_..." npx -y [email protected] --verify-otp [email protected] 123456

# List all 9 MCP tools and JSON schemas (runs locally in-process)
node index.mjs --list-tools

# Validate an EU or Northern Ireland (XI) B2B VAT ID (auto-converts Greece GR -> EL)
node index.mjs --check-vat GR123456789 DE

# Calculate 0% take-rate ROI and optimal flat-rate plan fit (runs locally in-process)
node index.mjs --calc-roi 10000 600 25 250000

# Simulate out-of-order webhook replay and 72-hour deduplication state machine (runs locally)
node index.mjs --sim-replay out_of_order_stale_update_after_cancel

# Lint Stripe dispute evidence UTF-16 code units and non-destructive CE 3.0 markers (runs locally)
node index.mjs --lint-evidence valid_ce3_non_destructive

# Verify webhook HMAC-SHA256 using REVCLAMP_WEBHOOK_SECRET from environment (runs locally)
REVCLAMP_WEBHOOK_SECRET="whsec_test_secret_revclamp_sandbox_2026" node index.mjs --verify-webhook stripe

# Invoke Visa CE 3.0 readiness staging locally (pass demo: true for synthetic sample or usageEvents for real logs)
node index.mjs --call revclamp_stage_stripe_dispute_ce3 '{"disputeId":"du_1Qxyz01","customerId":"cus_ent_88","disputeReason":"fraudulent","demo":true}'

アーキテクチャとエンジニアリングの詳細解説（事後分析 7 件とインタラクティブなブラウザツール 8 個）

1. Stripe 2025-03-31.basil エンタイトルメントガードとVisa CE 3.0の2段階ルーティング

• エンジニアリング事後検証 #1： Stripeのbasil APIで猶予期間のロジックが壊れ、CE 3.0はルーティングの問題だと判明しました
• エンジニアリング事後検証 #7： Visa CE 3.0の「18,000 UTF-16コード単位」の証拠切り詰めと非破壊ステージング
• インタラクティブツール（登録不要）：
  • 無料のStripe 2025-03-31.basil ゴースト使用量監査ツール
  • 無料のVisa CE 3.0準備状況チェッカー
  • 無料のStripe異議申し立て証拠用18,000 UTF-16文字リンター

2. EU VIESのHTTP 200 OKソフト障害サーキットブレーカーとB2B後払い条件の照合

• エンジニアリング事後検証 #2： VIESは停止中でもHTTP 200を返すため、誤ったVATを請求してしまいました
• エンジニアリング事後検証 #3： Shopify Plus B2BのNet-15/30/60における、整数セント単位のデポジットとクレジットノートの照合
• インタラクティブツール（登録不要）：
  • 無料のEUおよびXI VIES VAT 20 ID一括検証ツール
  • 無料のShopify Plus B2B後払い条件デポジット・クレジットノート計算ツール

3. Webhook HMAC-SHA256の生ボディセキュリティ、72hリプレイFSM、テイクレート0%のROI

• エンジニアリング事後検証 #4： 解析済みJSONボディではStripeとShopifyのWebhook HMAC-SHA256検証が失敗する理由
• エンジニアリング事後検証 #5： チャージバック成功報酬（25%～30%）と定額制・手数料0%の自動化を比較
• エンジニアリング事後検証 #6： Webhookの冪等性と順不同のサブスクリプションステートマシン
• インタラクティブツール（登録不要）：
  • 無料のStripe、Shopify、RevClamp Webhook HMAC-SHA256署名テスター
  • 無料のB2BチャージバックROI・テイクレート計算ツール
  • 無料の72h Webhookリプレイ・順不同ステートマシンシミュレーター

セキュリティとリソース上限

• ローカル優先の決定論的実行： 外部のnpm依存関係なしで、9つのツールすべてをlocal_engine.mjs内のプロセスでローカル実行します。
• 厳格なオリジン固定（クラウドモード）： REVCLAMP_API_KEYが指定されている場合、TLS経由でhttps://api.revclamp.com/api/mcpまたはhttps://revclamp.com/api/mcpにのみ接続します（redirect: "error"）。
• 実行の制限： リクエストタイムアウトを10,000ms（AbortSignal.timeout）に固定し、リクエスト／レスポンスのペイロード上限を32,768バイトに制限します。
• LLM向け完全リファレンス： https://revclamp.com/llms-full.txt

ライセンス

MIT © RevClamp Enterprise