defillama-mcp-server

DeFi Llama MCP 服务

一个用于 DeFi Llama 的 MCP 服务 — 将任意兼容 MCP 的客户端连接到免费的 DeFi 协议数据。

这是什么？

一个 MCP（模型上下文协议） 服务，可让 AI 助手和 Agent 通过自然语言访问 DeFi Llama 免费的 DeFi 数据 API — 包括协议 TVL、链 TVL、收益池、稳定币、跨链桥、DEX 交易量和协议费用。

可将它与 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 至少为 $10M 的高收益稳定币池”
• “列出市值最高的 5 种稳定币”
• “哪些跨链桥的 TVL 最高？”
• “展示过去 24h 的 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 至少为 $10M 的高收益稳定币池” — 按链、项目、最低 TVL 和资产类型筛选收益机会。无需翻阅各种仪表板，即可找到安全收益。

链分析

“Arbitrum 上的 TVL 总额是多少？” — 获取链级统计数据，包括按 TVL 排名的热门代币。可用于了解流动性流向以及哪些链正在增长。

稳定币情报

“按市值列出排名前 5 的稳定币”——跟踪稳定币市值、流通供应量和价格偏差。这对于了解 DeFi 以美元计价的流动性至关重要。

跨链监控

“哪些桥接协议的 TVL 最高？”——监控跨链桥接活动和交易量。跟踪哪些桥接协议的市场份额在上升或下降。

协议收入跟踪

“手续费最高的协议有哪些？”——分析协议手续费的产生情况和收入。可用于基本面分析和比较协议经济状况。

安全性

• 无需 API 密钥——使用 DeFi Llama 的免费公共 API。无需身份验证。
• 只读——仅从 DeFi Llama 的 API 获取公开的 DeFi 数据，不会写入或修改数据。
• 不访问本地文件——不会读取或写入你机器上的任何文件。
• 不访问 Shell——不会执行命令或启动进程。
• 请求限流——自动限制请求频率，礼貌地使用 API。
• 开源——采用 MIT 许可证。可在 GitHub 查看代码。

故障排除

“找不到协议”错误

先使用 search_protocols 查找正确的 DeFi Llama slug。协议 slug 使用小写字母和连字符（例如 aave-v3、lido），而非代币代码。

响应缓慢

DeFi Llama 的 /protocols 和 /pools 端点会返回数 MB 的响应。服务会将请求限流至约每秒 2 次。对于大型查询，结果可能需要 1–2 秒才能返回。

服务无法启动

确保已安装 Node.js 18+：node --version。如果使用 npx，请确保 npm 为最新版本：npm install -g npm@latest。

MCP 客户端无法连接

确认配置路径正确。在 macOS 上，Claude Desktop 使用 ~/Library/Application Support/Claude/claude_desktop_config.json；在 Windows 上使用 %APPDATA%\Claude\claude_desktop_config.json。更改配置后请重启客户端。

要求

• Node.js 18+
• 无需 API 密钥（DeFi Llama 提供免费公共 API）

请求限流

DeFi Llama 未公布严格的请求速率限制，但服务会自动将请求限流至约每秒 2 次（最小间隔为 500 毫秒），以礼貌地使用 API。/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