defillama-mcp-server

DeFi Llama MCP サーバー

DeFi Llama 用の MCP サーバーです。MCP 対応クライアントを接続して、無料の DeFi プロトコルデータを利用できます。

これは何ですか？

DeFi Llama の無料 DeFi データ API（プロトコルの TVL、チェーンの TVL、イールドプール、ステーブルコイン、クロスチェーンブリッジ、DEX の取引量、プロトコルの手数料）に、AI アシスタントやエージェントが自然言語でアクセスできる MCP（Model Context Protocol） サーバーです。

Claude Desktop、Cursor、Windsurf、Cline、Continue、または任意の MCP 対応クライアントと組み合わせて、DeFi プロトコルについて質問したり、TVL の動きを追跡したり、イールドを比較したり、オンチェーン経済を調べたりできます。

使う理由

• API キー不要 — DeFi Llama は無料の公開 API です
• ツールを 8 つ内蔵 — よく使われる DeFi データの問い合わせに対応します
• 見やすい Markdown 出力 — チャットで自然に読める結果が得られます
• 自動レート制限 — すべてのエンドポイントで 500ms の間隔を設けます

ツール

ツール	説明
search_protocols	名前で DeFi プロトコルを検索します。TVL、チェーン、カテゴリを含む上位の結果を返します
get_protocol_tvl	特定のプロトコルの詳細な TVL 内訳（チェーン別分布、履歴、説明）を取得します
get_tvl_by_chain	特定のチェーン（Ethereum、Arbitrum、Base、Solana など）の合計 TVL を取得します
get_yields	レンディングプールやステーキングのイールド／APY データを取得します。チェーン／プロジェクト／最小 TVL で絞り込めます
get_stablecoins	ステーブルコインの時価総額データとランキングを取得します
get_bridges	クロスチェーンブリッジの TVL と取引量のデータを取得します
get_dex_volumes	各チェーンの DEX 取引量を取得します
get_protocol_fees	プロトコルの手数料と収益のデータを取得します

クイックスタート

1. MCP クライアントに追加する

MCP クライアントの設定（例：claude_desktop_config.json）に、次の内容を追加します。

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

これで完了です。npx が自動的にダウンロードして実行します。API キーもインストール手順も必要ありません。

2. 使用する

AI アシスタントに、次のような質問をしてみましょう。

• 「Ethereum で TVL が高い DeFi プロトコルを教えてください」
• 「Aave を検索して、チェーン別の内訳を見せてください」
• 「Arbitrum の合計 TVL はいくらですか？」
• 「Base で TVL が 1,000 万ドル以上の、利回りが最も高いステーブルコインプールを見せてください」
• 「時価総額順に上位 5 つのステーブルコインを一覧表示してください」
• 「TVL が最も高いブリッジはどれですか？」
• 「過去 24 時間の DEX 取引量を見せてください」
• 「手数料が最も高いプロトコルを教えてください」

出力例

search_protocols

Top 5 protocols matching "aave" (by TVL):

- **Aave** (AAVE) — TVL: $12.45B | Category: Lending | Chains: Ethereum, Arbitrum, Polygon, Base, Optimism, +6 | Slug: `aave`
- **Aave v2** (AAVE) — TVL: $4.20B | Category: Lending | Chains: Ethereum, Polygon, Avalanche | Slug: `aave-v2`
- **Aave v3** (AAVE) — TVL: $8.10B | Category: Lending | Chains: Ethereum, Arbitrum, Polygon, Base, Optimism | Slug: `aave-v3`

get_yields

Top 5 yield pools (chain: Ethereum | min TVL: $10.00M | min APY: 0%):

- **Lido** — stETH on Ethereum 🟢 | APY: 3.42% (3.42% base) | TVL: $23.45B
- **Aave v3** — USDC on Ethereum 🟢 | APY: 4.85% (1.50% base + 3.35% reward) | TVL: $1.85B
- **Compound v3** — USDC on Ethereum 🟢 | APY: 5.12% (3.20% base + 1.92% reward) | TVL: $890.45M

get_tvl_by_chain

Ethereum — Chain TVL

- **Total TVL:** $115.32B
- **Native Token:** ETH
- **CoinGecko ID:** ethereum

### Top Tokens by TVL
- **ETH** (Ether): $67.23B
- **USDC** (USD Coin): $4.12B
- **USDT** (Tether): $3.45B
- **WBTC** (Wrapped BTC): $2.89B
- **WSTETH** (Wrapped stETH): $2.34B

ユースケース

DeFi 調査

「Aave を検索して、チェーン別の内訳を見せてください」— プロトコルを探し、チェーンごとの TVL を比較して、価値がどこに集中しているかを把握できます。DeFi Llama の 3,000 以上のプロジェクトを収録したデータベース内の、あらゆるプロトコルで利用できます。

イールドの最適化

「Base で TVL が 1,000 万ドル以上の、利回りが最も高いステーブルコインプールを見せてください」— チェーン、プロジェクト、最小 TVL、資産タイプでイールドの機会を絞り込めます。ダッシュボードを探し回らずに、安全なイールドを見つけられます。

チェーン分析

「Arbitrum の合計 TVL はいくらですか？」— TVL 上位のトークンを含む、チェーン単位の統計情報を取得できます。流動性の流れや、成長しているチェーンを把握するのに役立ちます。

ステーブルコインのインテリジェンス

「時価総額上位5つのステーブルコインを一覧表示して」— ステーブルコインの時価総額、流通供給量、価格の乖離を追跡します。DeFiにおけるドル建て流動性を理解するために不可欠です。

クロスチェーンのモニタリング

「TVLが最も多いブリッジはどれですか？」— クロスチェーンブリッジのアクティビティと取引量を監視します。シェアを拡大または縮小しているブリッジを追跡します。

プロトコル収益の追跡

「手数料が最も多いプロトコルはどれですか？」— プロトコルの手数料生成と収益を分析します。ファンダメンタル分析やプロトコルの経済性の比較に役立ちます。

セキュリティ

• API キー不要 — DeFi Llama の無料公開 API を使用します。認証は必要ありません。
• 読み取り専用 — DeFi Llama の API から公開 DeFi データを取得するだけです。書き込みや変更は行いません。
• ローカルファイルへのアクセスなし — お使いのマシン上のファイルの読み取りや書き込みは行いません。
• シェルへのアクセスなし — コマンドの実行やプロセスの起動は行いません。
• レート制限あり — API に配慮した利用者として、リクエスト数を自動的に制限します。
• オープンソース — MIT ライセンスです。コードは GitHub で確認できます。

トラブルシューティング

「Protocol not found」エラー

まず search_protocols を使って、正しい DeFi Llama のスラッグを検索してください。プロトコルのスラッグはティッカーシンボルではなく、小文字とハイフンで構成されています（例：aave-v3、lido）。

応答が遅い

DeFi Llama の /protocols および /pools エンドポイントは、数 MB の応答を返します。サーバーは約2回／秒にスロットリングします。大規模なクエリでは、結果の取得に1～2秒かかることがあります。

サーバーが起動しない

Node.js 18 以降がインストールされていることを確認してください：node --version。npx を使用している場合は、npm が最新であることを確認してください：npm install -g npm@latest。

MCP クライアントが接続できない

設定ファイルのパスが正しいことを確認してください。Claude Desktop では、macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json を使用します。設定を変更した後は、クライアントを再起動してください。

要件

• Node.js 18 以降
• API キー不要（DeFi Llama は無料の公開 API です）

レート制限

DeFi Llama は厳密なレート制限を公開していませんが、サーバーは API に配慮した利用者として、リクエストを自動的に約2回／秒（最小間隔500ミリ秒）にスロットリングします。/protocols および /pools エンドポイントは数 MB と大きいため、このスロットリングは不要な負荷の回避にも役立ちます。

データソース

• プロトコルと TVL： https://api.llama.fi
• 利回り： https://yields.llama.fi
• ステーブルコイン： https://stablecoins.llama.fi

すべてのエンドポイントは無料で、認証は不要です。API の全ドキュメント：https://defillama.com/docs/api

開発

git clone https://github.com/nova/defillama-mcp-server.git
cd defillama-mcp-server
npm install
npm run build
npm start

ライセンス

MIT