Web3Juice

web3juice-mcp

根拠を確認できる DeFi 利回りデータを AI アシスタントに。 Claude、Cursor、または任意の MCP クライアントに、約 17,000 件の DeFi プールの利回り、利回りの内訳（ベーストークンと報酬トークン）、過去 90 日間の推移、プール間の比較を問い合わせられます — すべての数値に日付と出典へのリンクが付いています。

このパッケージは、ローカルの stdio MCP クライアントから、ホスト型の Web3Juice MCP サーバー （https://web3juice.com/api/mcp）へ接続する、小さな依存関係のないブリッジです。リモートサーバーに対応したクライアントは、この URL に直接接続できます。web3juice.com/mcp をご覧ください。

読み取り専用です。ウォレットの秘密鍵を参照したり、トランザクションに署名したり、資金を移動したりすることはありません。投資助言ではありません。

クイックスタート

Claude Desktop → Settings → Developer → Edit Config の順に開き、次を追加します。

{
  "mcpServers": {
    "web3juice": {
      "command": "npx",
      "args": ["-y", "web3juice-mcp"]
    }
  }
}

Claude Desktop を再起動し、次のように質問します：「各チェーンで、現在の USDC の貸し出し利回りはいくらですか？」

Node.js 18.17 以降が必要です。

API キーを使う場合（上限の引き上げ、Pro で独自のアラートとノートブックを利用）

Web3Juice アカウントページでキーを作成し、環境変数として追加します。

{
  "mcpServers": {
    "web3juice": {
      "command": "npx",
      "args": ["-y", "web3juice-mcp"],
      "env": {"WEB3JUICE_API_KEY": "w3j_your_key_here"}
    }
  }
}

その他のクライアント

Claude Code（リモート、インストール不要）：

claude mcp add --transport http web3juice https://web3juice.com/api/mcp

Claude Code プラグイン（このリポジトリはプラグインマーケットプレイスでもあります）：

claude plugin marketplace add jimbob1414/web3juice-mcp

claude plugin install web3juice@web3juice

独自の上限を利用するには、環境に WEB3JUICE_API_KEY を設定します。

Cursor、VS Code、ChatGPT、Claude.ai など： web3juice.com/mcp をご覧ください。

Claude Desktop 拡張機能： 最新リリースから web3juice.mcpb をダウンロードして開きます。

ツール

ツール	内容
summarize_yields	任意のフィルターに基づく市場概要：チェーン、プロトコル、または戦略別の中央値と TVL 加重 APY。
search_pools	トークン、チェーン、プロトコル、APY、TVL でプールを検索して順位付けします。
get_pool	1 つのプールの APY 内訳、TVL、データの鮮度、コントラクトとトークンのアドレス、入金先と出典へのリンク、評価を表示します。
get_pool_history	日付付きサンプルを含む、過去 7／30／90 日間の APY 推移。
compare_pools	2～5 件のプールを並べて、30 日間の範囲を比較します。
get_data_sources	データフィードの稼働状況と最終更新日時。
get_methodology	実験的な根拠評価の仕組み。

Pro、Power、または Team キーを使うと、読み取り専用のワークスペースツールが追加されます：list_alerts、get_alert、 list_notebook_entries、get_notebook_entry、list_investments、list_wallets、get_wallet_positions。

プロンプト：find_stablecoin_yields、analyse_pool、compare_yields、yield_market_snapshot。 リソース：web3juice://guide、web3juice://methodology、web3juice://data-sources、web3juice://pool/{poolId}。

上限と料金

	キーなし	無料アカウントキー	Pro（£10/月）	Power（£39/月）
1 日あたりの呼び出し数	アドレスごとに 500	500	10,000	50,000
1 分あたりの呼び出し数	30	30	120	300
独自のアラート、ノートブック、投資、ウォレット	—	—	はい	はい

現在の料金：web3juice.com/pricing。

設定

変数	デフォルト	用途
WEB3JUICE_API_KEY	なし	任意のキー（w3j_…）。設定しない場合は無料の上限が適用されます。
WEB3JUICE_MCP_URL	https://web3juice.com/api/mcp	サーバー URL。https:// が必要です（通常の http は localhost の場合のみ）。
WEB3JUICE_MCP_DEBUG	オフ	1 に設定すると、stderr にログを出力します。

セキュリティ

• ブリッジは MCP メッセージのみを stdout に書き込み、診断情報は stderr に出力します。
• API キーは、設定された HTTPS URL に Authorization ヘッダーでのみ送信されます。ログに記録されることはありません。
• キーで実行できるのは読み取りのみです。アカウントページでいつでもキーを失効できます。次の呼び出しは、明確なメッセージとともに失敗します。
• プール名とラベルはサードパーティのデータソースに由来し、指示ではなくデータとして扱われます。

トラブルシューティング

問題	対処方法
npx が見つからない／サーバーが起動しない	nodejs.org から Node.js 18.17+ をインストールしてから、クライアントを再起動してください。
「API key is not valid or has been revoked」	アカウントページで新しいキーを作成し、WEB3JUICE_API_KEY を更新してください。
「Daily MCP limit reached」	00:00 UTC まで待つか、キーを追加するか、web3juice.com/pricing でアップグレードしてください。
検索結果が表示されない	デフォルトでは、TVL が $100K 以上で、データが 60 分以内のプールが検索対象です。より小規模なプール、またはより古いデータを指定してください。
レートが 100 倍大きく見える	フィルターには小数を使用します。0.05 は 5% を意味します。

ライセンス

このブリッジには MIT ライセンスが適用されます。web3juice.com のデータおよびサービスは、このライセンスの対象外です。