YieldCave

YieldCave

AI エージェント向けの機械可読なトークン化金融データ：トークン化された米国債、ステーブルコインの利回り獲得先、トークン化された株式。

YieldCave は MCP サーバーです。Claude Desktop、Claude Code、または Cursor に追加すると、エージェントが次のような質問に答えられるようになります。

• 「現在、Solana 上にはどのようなトークン化された米国債があり、利回りはいくらですか？」
• 「担保付きのトークン化された米国債のうち、流動性が最も高いものに 2 万 5 千ドルを預けた場合、利率 0.4％の普通預金口座よりいくら多く稼げますか？」
• 「トークン化された RWA 市場を要約してください。」
• 「少なくとも 5,000 万ドルの資金がある担保付きレンディング市場で、USDC の利回りが最も高いのはどこですか？」
• 「トークン化された NVIDIA トークンのうち、最も流動性が高いのはどれですか？また、株価に対してプレミアムで取引されていますか？」

読み取り専用です。ウォレットにアクセスしたり、資金を移動したり、推奨を行ったりすることはありません。それが目的です。ブローカーではなく、インデックスです。

データは DefiLlama のパブリック API から取得します。API キーは不要です。

1. ローカルで実行する（5 分）

Node 20 以降が必要です（node --version）。

cd ~/yieldcave && npm install

ターミナルでデータを確認します。

npm run demo

ユニットテストを実行します（ネットワーク接続は不要です）。

npm test

stdio と HTTP 経由で実際の MCP サーバーを起動し、Claude が使うのと同じ方法で呼び出す、エンドツーエンドのチェックを実行します。

npm run smoke && npm run smoke:http

2. Claude Desktop に追加する

次のファイルを開きます（存在しない場合は作成します）。

~/Library/Application Support/Claude/claude_desktop_config.json

mcpServers の下に YieldCave を追加します。ファイルにほかのサーバーがすでにある場合は、既存のオブジェクト内に "yieldcave" ブロックだけを追加します。

{
  "mcpServers": {
    "yieldcave": {
      "command": "node",
      "args": ["/Users/bjf/yieldcave/src/server.js"]
    }
  }
}

Claude Desktop を終了して再度開きます。YieldCave の 4 つのツールが表示されたツールアイコンが見えるはずです。次のように試してみてください。「YieldCave を使って、トークン化された米国債市場を要約してください。」

3. Claude Code に追加する

claude mcp add yieldcave -- node /Users/bjf/yieldcave/src/server.js

3b. ブラウザーで claude.ai から利用する（ホスト版）

YieldCave は Supabase 上のクラウドでも動作するため、お使いの Mac の電源が入っていなくても、claude.ai（およびほかのユーザー）からアクセスできます。

https://mcp.yieldcave.com

claude.ai で、Customize → Connectors → Add → Add custom connector を選択し、その URL を貼り付けます。サインインは不要です。ホスト版は Postgres からデータを提供します。データはスケジュールされたジョブによって 1 時間ごとに更新され、1 日に 1 つのスナップショットが保存されます。この履歴を使って 5 つ目のツール rwa_history が動作します。

ホスト版の構成はすべて supabase/ フォルダー内にあります。

supabase/functions/_shared/   the real code: data.js, tools.js, mcp.js (src/ re-exports these)
supabase/functions/mcp/       public MCP endpoint, reads market_latest and snapshots from Postgres
supabase/functions/refresh/   fetches DefiLlama + CoinGecko + quotes, writes market_latest + today's snapshot, fires alerts; needs REFRESH_SECRET header
supabase/functions/enrich/    fills chain metadata for tokenized equities, 15 per run, every 10 minutes
supabase/functions/stripe-webhook/  upgrades/downgrades keys on Stripe events
supabase/functions/site/      serves the landing page (pages.js is generated from site/)
supabase/migrations/          tables (market, snapshots, alerts, api_keys, usage_daily), RLS on, hourly pg_cron job, public site bucket
scripts/                      configure-stripe.sh, publish-site.sh

変更後に再デプロイするには、次のようにします。

supabase functions deploy mcp --no-verify-jwt --use-api && supabase functions deploy refresh --no-verify-jwt --use-api

デプロイがエンドツーエンドで機能することを確認します（ツール、履歴、自動で作成・発火・削除されるアラート）。

set -a; source .env.local; set +a; YIELDCAVE_URL=https://ccvhvxbqtvqbhexhrjnj.supabase.co/functions/v1/mcp npm run smoke:remote && npm run smoke:alerts

シークレット（データベースのパスワード、更新用シークレット）は .env.local に保存されます。このファイルは git の対象外です。絶対にコミットしないでください。

4. ツール

ツール	返される内容
list_rwa_yields	APY と TVL を含むトークン化 RWA のデプロイメントです。chain、kind（treasury または other_rwa）、minTvlUsd で絞り込み、tvlUsd または apy で並べ替えられます
get_rwa_asset	すべてのチェーンにおける 1 つのシンボル（例：BUIDL）の情報です。TVL の合計と、厳選された説明を含みます
list_stablecoin_yields	レンディング、ボールト、クレジット、ベーシスの各プラットフォームにおける単一資産のステーブルコインプール（USDC、USDT、DAI、USDe など）です。グループ別に分類され、ベース APY と報酬 APY、30 日平均、TVL を含みます。デフォルトでは 1,000 万ドル以上が対象です
stablecoin_yield_summary	ステーブルコインごとのプラットフォーム、TVL、APY の中央値、全体で最も利回りの高いプラットフォーム、担保付きレンディングで最も利回りの高いプラットフォームです。グループ別の合計と、比較用のトークン化国債の中央値も含みます
list_tokenized_equities	トークン化された株式、IPO 前の株式、ETF（xStocks、bStocks、Ondo、Robinhood、Dinari、Coinbase など）の情報です。価格、時価総額、取引高、原資産のティッカー、原資産の価格に対するプレミアム／ディスカウント、チェーンを含みます。データソース：CoinGecko、価格情報：Yahoo chart data
get_tokenized_equity	すべてのラッパーにおける 1 つの原資産（例：TSLA）の情報です。発行者、チェーン、最も流動性の高いトークン、プレミアムの範囲を含みます
tokenized_equity_summary	合計、発行者別および種類別の内訳、上位の原資産、プレミアムの統計情報です
rwa_market_summary	合計情報です。異なる国債トークン数、TVL、APY の中央値、上位 5 件、およびその他の RWA の合計を含みます
compare_yield_to_tokenized_treasuries	単利計算に基づき、現在の APY と、指定期間における最も利回りの高い流動性のあるトークン化国債を比較します。前提条件も明記されます
rwa_issuer_terms	BUIDL、USYC、USDY、OUSG、USTB、TBILL、STBT、BENJI の厳選された条件です。仕組み、対象条件（米国人かどうか）、最低額、償還、手数料、情報源、確認日を含みます
rwa_history	過去 N 日間の、1 つのシンボルの日次 TVL と TVL 加重 APY、およびその変化です。universe は rwa または stablecoin です。ホスト版では Postgres のスナップショットを使用します。ローカル版では npm run snapshot のファイルを使用します
rwa_changes	N 日前からの変化です。デプロイメントごとの APY と TVL の変化、新規および消失したデプロイメントを示します（ホスト版、またはスナップショットを使用するローカル版）
create_alert、list_alerts、delete_alert	ホスト版のみで、キーが必要です。「国債の APY が 4.5 を超える」や「USDY の TVL が 10 億ドルを下回る」などのルールを設定できます。1 時間ごとに確認し、24 時間に 1 回を上限として、HTTPS ウェブフック（Slack、Discord、Zapier、ご自身のサーバー）に JSON POST を送信します
create_api_key、my_usage、upgrade、manage_subscription	ホスト版のみです。メールアドレスによる無料キー（表示は 1 回のみ）、プランと利用状況、Pro のチェックアウトリンク、プラン変更または解約用の Stripe 請求ポータルリンクを利用できます

4b. プラン、キー、利用量の計測（ホステッド）

プラン	料金	呼び出し数／日	アラート	履歴	変更履歴	ステーブルコイン取引所	発行体の利用条件	トークン化された株式
匿名	$0	IP ごとに 100	0	7 日間	1 日前まで	レンディングとボールト、10 行	概要	10 行、プレミアムなし
無料キー	$0	300	3	7 日間	1 日前まで	レンディングとボールト、10 行	概要	10 行、プレミアムなし
Pro	$49/月	5,000	100	全期間	任意の期間	すべてのグループ、100 行	ソース付きの全記録	100 行、プレミアムとプレミアム順の並べ替え

ライブデータは無料で、詳細データは有料です。エージェントにメールアドレスを指定して create_api_key を呼び出すよう依頼し、キーを取得してください。x-api-key ヘッダー（または Authorization: Bearer）で送信するか、claude.ai のコネクター URL に ?key=yc_... として指定します。Pro は upgrade ツール（Stripe のチェックアウト）で購入し、manage_subscription で管理します。セルフホスト可能なサーバーにはプラン制限がありません。

キーを使った claude.ai のセットアップ。 claude.ai のカスタムコネクターはリクエストヘッダーを送信できないため、キーは URL に指定します。https://mcp.yieldcave.com/?key=yc_your_key を使ってカスタムコネクターを追加し、「サインインなし」を選択します。両方が指定されている場合は、ヘッダー（x-api-key または Authorization: Bearer）が優先されます。サーバーはクエリ文字列やキーをログに記録しません。URL を持つ人は誰でもキーを持つことになるため、URL は秘密として扱ってください。

すべての tools/call は、キーがある場合はそのキーに、匿名の呼び出し元の場合はハッシュ化された IP アドレスに紐づけて usage_daily テーブルにカウントされます。制限は UTC の午前 0 時にリセットされます。キーは SHA-256 ハッシュとして保存され、プレーンテキストのキーが返されるのは一度だけです。アラートは、作成したキーに紐づきます。これらの処理はすべて supabase/functions/mcp/index.ts にあり、制限自体は supabase/functions/_shared/plans.js にあります。

決済を有効にするには Stripe アカウントと 3 つの値が必要です。月額 $49 の継続課金商品を作成し、イベント checkout.session.completed、customer.subscription.deleted、customer.subscription.updated を指定して、https://ccvhvxbqtvqbhexhrjnj.supabase.co/functions/v1/stripe-webhook に Webhook エンドポイントを追加してから、次を実行します。

./scripts/configure-stripe.sh sk_live_... price_... whsec_...

それまでは、upgrade は「決済はまだ有効になっていません」という丁寧なメッセージを返します。Webhook はチェックアウト完了時にキーを Pro にアップグレードし、サブスクリプション終了時にダウングレードします。manage_subscription は Stripe の請求ポータルを開きます（戻り先 URL は https://yieldcave.com）。チェックアウト成功ページとキャンセルページは https://yieldcave.com/thanks と https://yieldcave.com です。必要になった場合は、SITE_URL シークレットで両方を上書きできます。

ランディングページは https://yieldcave.com で、Cloudflare（Workers の静的アセット、Cloudflare Pages の現行形式）でホストされています。site/*.html を編集してから、wrangler pages deploy を実行する ./scripts/publish-site.sh で公開します（初回は事前に npx wrangler login を一度実行してください）。site Edge Function は同じページの予備コピーで、どこからもリンクされていません。

すべてのレスポンスには免責事項とデータ取得時刻が含まれます。発行体の利用条件は supabase/functions/_shared/issuers.js で手作業により管理されており、verifiedOn 日付とソース URL が記録されています。利用条件が変更された場合は、このファイルを更新してください。

5. プロジェクトの構成

src/data.js     re-export of supabase/functions/_shared/data.js (fetch, normalize, cache, local snapshots, equities)
src/equities.js re-export of _shared/equities.js: tokenized stock parsing and tools
src/tools.js    re-export of _shared/tools.js: pure functions behind each tool (unit-tested)
src/mcp.js      re-export of _shared/mcp.js: declares the five tools
src/snapshot.js saves today's market locally (npm run snapshot)
src/server.js   stdio entry point: Claude Desktop, Claude Code, Cursor
src/http.js     HTTP entry point: claude.ai custom connectors, remote clients
src/demo.js     prints a summary table in the terminal
test/           unit tests (node --test) and a live smoke test
site/           landing page with a live table (npm run site, then open http://localhost:8080)

6. API を初めて使う人向けの仕組み

API は、ウェブページではなくデータを返す URL です。ブラウザーで https://yields.llama.fi/pools を開くと、約16,000件の利回りプールの生の JSON が表示されます。src/data.js はそのデータをダウンロードし、DefiLlama が実世界資産として分類するプールだけを残して、それぞれをわかりやすい名前の12個のフィールドに整形します。

MCP は、AI モデルが定義した関数を呼び出せるようにする小さなプロトコルです。src/server.js はモデルに「4つの関数があり、それぞれの引数の意味はこうです」と伝えます。モデルが関数の呼び出しを決めると、サーバーは src/tools.js 内の対応する関数を実行し、JSON を返します。Claude はその JSON を読み取り、英語で回答を書きます。

サーバーは stdio（標準入力／標準出力）で通信します。そのため、内部で console.log を使うことは禁止されています。標準出力に出力すると、プロトコルのストリームが破損するためです。デバッグには console.error を使用してください。

7. 次のステップ

ホスト型エンドポイント、履歴、発行者の利用規約、Webhook アラート、API キー、使用量計測はすでに利用できます。Pro を有効にするには、Stripe アカウントがあれば十分です。次の予定は、カスタムドメインの追加と、トークン化株式などの資産クラスの拡充です。

免責事項

情報提供のみを目的としており、金融アドバイスではありません。数値は公開されているサードパーティーデータに基づいており、遅延している場合や誤っている場合があります。行動に移す前に、発行者に確認してください。

ライセンス

MIT