VidFare

VidFare MCP サーバー

VidFare の料金カタログを参照する、公開読み取り専用のModel Context Protocolサーバーです。認証なしで、/mcp において Streamable HTTP を使用します。ChatGPT、Claude、Cursor などのクライアントは、モデルの一覧表示、料金の確認、クリップの見積もり、セールの一覧表示を実行できます。すべての結果には、VidFare のソース URL、最終確認日、vidfare.com のページへのリンクが含まれます。これらの vidfare.com リンクには、utm_source=mcp&utm_medium=tool&utm_campaign=vidfare_mcp も付加されます。

Worker は https://mcp.vidfare.com/mcp で稼働中です。このリポジトリから wrangler login や wrangler deploy を実行しないでください。

データ

Worker が取得するのは次のデータのみです。

• https://vidfare.com/data/prices.json
• https://vidfare.com/deals.json（同じ JSON が /data/deals.json にも公開されています）

レスポンスは5分間キャッシュされます。取得に失敗した場合や、カタログにリクエストされた料金の記載がない場合、ツールはその旨を伝え、数値を補完しません。

ツール

ツール	引数
list_models	なし
get_model_prices	model（必須）、provider、resolution
estimate_cost	model、seconds（必須）。任意：resolution、audio（with、without、on、off）、input（t2v、i2v、ref2v、v2v、extend、lip-sync）、plan、provider、used（1～100、デフォルトは100）、apply_deals（デフォルトはfalse）、window_seconds（デフォルトは60）
cheapest_options	seconds、resolution（どちらも必須）。任意：audio、input、used、apply_deals
list_deals	status：live（デフォルト）、upcoming、ended、all

estimate_cost は、クレジット計算ツール（scripts/variations.py）と同じ行フィルターを使用し、計算スクリプトと同じプラン計算を行います。プラン料金 ÷ クレジット数 × クリップあたりのクレジット数を計算し、さらに実際に使用したクレジットの割合で割ります。API の行では、請求対象の秒数に記載された秒単価を掛けます。scripts/test_mcp_parity.py でサイトのコードとの一致を確認します。

使用回数

tools/call が1回呼び出されると、Workers Analytics Engine に1つのポイントが書き込まれます。blob1 はツール名（5つのツール以外の場合は unknown）、blob2 は success または error、double1 は 1 です。時刻はエンジンに保存されます。UTC の日付はそのタイムスタンプに基づきます。読み取りスクリプトでは、その UTC の午前0時が太平洋時間で何時にあたるかも表示されます。それ以外は何も保存されません。引数、プロンプト、IP アドレス、ユーザーエージェント、セッション ID、国は保存されません。公開統計 URL はありません。

カウントされるのはツールのリクエストであり、ユニークユーザー、訪問数、スポンサーのインプレッションではありません。リトライ、同じユーザーからの2回目の呼び出し、テストヘッダーを送信しないクライアントは、それぞれ1回として加算されます。X-VidFare-Test: 1 を含むリクエスト、および localhost または 127.0.0.1（wrangler dev）への POST は記録されません。initialize、tools/list、通知、OPTIONS、GET も記録されません。ツールを呼び出したクローラーや他者のテストクライアントはカウントされます。

書き込みは完了を待たず、失敗しても無視されるため、カウンターのエラーがツールのレスポンスに影響することはありません。

wrangler.jsonc は USAGE を vidfare_mcp_usage データセットにバインドします。データセットは最初の書き込み時に作成されます。このバインドをデプロイするには、既存の Worker デプロイトークン（Workers Scripts Edit または Workers Admin、Workers Routes Edit、Zone Read）を使用します。Analytics Read は必要ありません。カウントを読み取るには必要です。VidFare アカウントをスコープにして、Account → Account Analytics → Read 権限の別のトークンを作成し、次を実行します。

CLOUDFLARE_ACCOUNT_ID=... CLOUDFLARE_API_TOKEN=... python3 scripts/mcp_usage.py

そのトークンをリポジトリに入れないでください。

ローカル

cd mcp-server
npm install
npm test
npx wrangler dev

wrangler dev はこのマシン上で動作します。デプロイは行いません。

Cursor では mcp-server/.mcp.json を使用できます。同じ JSON をプロジェクトの .cursor/mcp.json に配置してください。URL は https://mcp.vidfare.com/mcp です。

レジストリ

server.json は MCP レジストリドキュメントです。名前は com.vidfare/vidfare です。リモートは https://mcp.vidfare.com/mcp の streamable-http です。

com.vidfare の名前空間検証は HTTP です。サイトは公開済みの証明レコードを https://vidfare.com/.well-known/mcp-registry-auth で提供します。ファイルは v=MCPv1; k=ed25519; p=<public key> の1行です。秘密鍵はこのリポジトリにはありません。

サイトのビルドでは、ファイルを dist/.well-known/ にコピーし、dist/.nojekyll を書き込みます。actions/upload-pages-artifact は include-hidden-files が true でない限り、ドットで始まるパスを除外します。両方のデプロイワークフローでこれを設定しているため、URL はリダイレクトなしで 200 を返します。

後でデプロイする場合

トークン、Cloudflare アカウント1つ（vidfare.com を所有するアカウント）、ゾーン1つ（vidfare.com のみ）：

スコープ	権限	理由
Account、Workers product	Workers Admin	最初の wrangler deploy で Worker が作成されます。既存の Worker の編集しかできないトークンでは、Worker を作成できません。従来のトークン形式では、この権限は引き続き Account → Workers Scripts → Edit と表示されます。この従来の権限でもスクリプトを作成できます。新しいロール選択画面が表示された場合は、Editor ではなく、Workers product の Workers Admin を選択してください。
Zone vidfare.com	Workers Routes → Edit	カスタムドメイン mcp.vidfare.com を割り当てます。現在のドキュメントでは Workers Routes Write と呼ばれています。
Zone vidfare.com	Zone → Read	Wrangler が vidfare.com のゾーン ID を検索します。

Workers KV、R2、Tail、Account Settings、DNS、ユーザーメンバーシップの権限は追加しないでください。Worker にバインディングはありません。

vidfare.com の DNS レコードは、ダッシュボードで作成します（上記のトークンでは DNS を編集できません）。

Type	Name	Content	Proxy
AAAA	mcp	100::	プロキシ経由

これは Worker のカスタムドメインが使用するプロキシ経由のホスト名です。wrangler.jsonc では、ルートにカスタムドメイン mcp.vidfare.com を設定しています。レコードの作成後、このディレクトリから npx wrangler deploy を実行すると Worker が公開されます。リポジトリ内ではなく、環境に CLOUDFLARE_API_TOKEN が必要です。