关于 Defillama
Defillama 是面向 AI Agent 和 DeFi 研究者的 MCP 服务,可查询跨链协议指标、收益率、稳定币及代币解锁数据,并提供收入排名。支持通过网关连接或本地独立运行。
主要功能
- 01跨链协议 TVL 与排名
- 02收益率和稳定币指标
- 03DEX 与衍生品交易量
- 04代币解锁和归属数据
- 05协议收入排名
适用场景
- 01比较不同链上的协议 TVL
- 02按当前收益率查找资金池
- 03追踪稳定币供应量和流向
- 04查看代币解锁计划
MCP 相关
通过 Pipeworx 网关或本地 stdio MCP 服务,向 MCP 客户端提供 DefiLlama 数据工具。网关连接还包含 Pipeworx 通用元工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/defillama/mcpclaude mcp add --transport http pipeworx-io-defillama https://gateway.pipeworx.io/defillama/mcp{"mcpServers":{"pipeworx-io-defillama":{"type":"http","url":"https://gateway.pipeworx.io/defillama/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-defillama":{"type":"http","url":"https://gateway.pipeworx.io/defillama/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-defillama":{"type":"http","url":"https://gateway.pipeworx.io/defillama/mcp"}}}{"mcpServers":{"pipeworx-io-defillama":{"serverUrl":"https://gateway.pipeworx.io/defillama/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
49| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | string | 否 | question 的别名。 |
| ask | string | 否 | question 的别名。 |
| text | string | 否 | question 的别名。 |
| input | string | 否 | question 的别名。 |
| packs | array | 否 | 可选。将路由限制为这些包的 slug(例如 ["sec-form-d","sec-13f"]),路由器随后只会从这些包中的工具进行选择。省略则使用默认的完整目录路由。Slug 可从 list_packs / search_packs / https://pipeworx.io/directory 获取;未列出或未知的 slug 会被忽略,并在 _meta.pack_scope.ignored 中列出。如果没有任何 slug 能匹配问题,则会在整个目录中路由,并设置 _meta.pack_scope.full_catalog:true(绝不会返回空答案)。 |
| query | string | 否 | question 的别名。 |
| prompt | string | 否 | question 的别名。 |
| message | string | 否 | question 的别名。 |
| question | string | 是 | 用自然语言表达的问题或请求。支持 query、q、prompt、text、input、ask、message 作为别名。 |
详细介绍
DefiLlama — DeFi 协议指标
DefiLlama 是去中心化金融领域权威的免费仪表板和 API。涵盖所有主要链和协议的 TVL(总锁仓价值)、协议代币、收益聚合器、稳定币、衍生品、借贷市场和 DEX 交易量。加密领域人人都在使用。免费,无需身份验证。
这是 Pipeworx 的一部分——一个将 AI Agent 接入 1878+ 个实时数据源的 MCP 网关。这是独立的非官方集成,与上游提供商无关联、未获其认可,也非由其发布。
这对 AI Agent 有何意义
对于 DeFi 研究——比较收益率、追踪协议间的 TVL 流动、分析稳定币发行量、监控清算情况——DefiLlama 是首选数据源。数据经过跨链标准化(Ethereum、Solana、Base、Arbitrum 等),便于合理地进行跨链比较。可搭配 Alpha Vantage 或 Finnhub,查看与公开股票市场的交集(Coinbase、Microstrategy 等)。
常见工作流:
-
协议 TVL。 “Aave 的 TVL 是多少?”→ 当前 TVL 及历史数据。
-
TVL 排行榜。 “按 TVL 排名前 20 的 DeFi 协议”→ 排名。
-
收益搜索。 “现在最好的稳定币收益率是多少?”→ 各资金池的 APY,以及交易量和风险指标。
-
稳定币供应量。 “各条链上的 USDC 供应量”→ 发行量和跨链桥流动情况。
-
DEX 交易量。 按交易所或交易对统计的交易量。
-
代币解锁。 “本周有哪些代币计划解锁?”/“2026-10-05 至 2026-10-12 期间,解锁金额超过 $10M 的项目”→
defi_token_unlocks:涵盖约 370 种代币的每次归属 cliff 和发行速率变化,并提供代币数量、美元价值、占流通供应量的比例及接收方。 -
单个代币的归属计划。 “Hyperliquid HYPE 解锁计划”→
defi_token_emission:按类别划分的分配情况、各接收方当前已解锁与最终解锁数量,以及过去和未来的解锁日期。
代币解锁数据
defi_token_unlocks 和 defi_token_emission 读取 DefiLlama 的公开解锁数据集(defillama-datasets.llama.fi——与 https://defillama.com/unlocks 所呈现的文件相同)。该功能对应的文档化 API 路由(api.llama.fi/emissions)会返回 402 Upgrade to the paid API plan,因此这些工具不会使用该路由。每个响应都包含 data_as_of(数据集文件的 Last-Modified 时间)和 price_as_of。
- 美元价值使用当前价格,而非解锁日期的价格。过去一次解锁的
cliff_usd表示这些代币按当前价格计算的价值。 - 并非每项分配都有计划。 有些代币(包括 Hyperliquid)的数据仅记录过去的解锁;其余供应量会计入
supply_metrics.tbdAmount,且没有公布日期。响应会说明这一点,而不会返回空的未来解锁数据。 emission_rate_changes表示线性归属速率的变化(每周代币数量),没有单一的美元金额;min_usd筛选条件会将其过滤掉。
身份验证
免费,无需身份验证。DefiLlama 由社区支持,欢迎使用其 API;速率限制较宽松。
追踪范围
| 垂直领域 | 覆盖范围 |
|---|---|
| TVL | 所有主要 DeFi 协议,汇总多条链的数据 |
| 稳定币 | 各链上每种代币的发行量;跨链桥流动情况 |
| 收益率 | 借贷、LP、金库、再质押收益率 |
| DEX | 按交易所、交易对和链统计的交易量 |
| 衍生品 | 永续合约、期权交易平台 |
| 跨链桥 | 跨链转账量 |
| NFT | (覆盖有限;建议使用专用 NFT 工具) |
常见陷阱
- TVL ≠ 协议价值。 TVL 是存入资产的美元金额,不反映协议收入、代币价格或实际使用情况。某个协议可能拥有 10 亿美元 TVL,却没有用户(存款闲置无人使用)。
- 跨链重复计数。 某个协议在 Ethereum 和 Arbitrum 上都有 TVL。DefiLlama 大多能处理这种情况,但在特殊情况下(资产先跨桥再存入)可能会重复计数。
- 收益率衰减。 池中的 APY 变化很快。“当前 APY”快照可能维持不了几天。计算“预期回报”时,请使用更长期的平均值。
- 风险未计入价格。 APY 为 100% 的池并非天上掉馅饼——这通常意味着无常损失风险、智能合约风险或代币发行通胀风险较高。DefiLlama 会提供一些风险指标,但 Agent 应醒目地报告这些指标。
- 稳定币供应量 ≠ 稳定性。 “稳定币”供应量反映代币层面的供应量。并非所有稳定币的稳定性都相同(USDT、USDC ≈ 真正稳定;算法稳定币可能会偏离锚定价格)。信任度取决于发行方和机制。
- 桥接数据只是近似值。 跨链流量通过桥接合约追踪;并非所有桥都受监控,中心化桥接(CEX 存款/取款)也不可见。
- 代币价格因数据源而异。 DefiLlama 有自己的价格指数,可能与 CoinGecko / CoinMarketCap 略有不同。若需高精度价格数据,请使用专用价格预言机。
收入排名
defi_revenue_ranking({ data_type?, period?, sort_by?, category?, chain?, limit? }) 按过去 24h / 7d / 30d 的收入(或费用)为协议排名,并提供上一时期的值和百分比变化。数据源:DefiLlama 费用和收入数据集。将返回的 slug 传入 defi_protocol_fees,即可获取每日时间序列。
快速开始
添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"defillama": {
"url": "https://gateway.pipeworx.io/defillama/mcp"
}
}
}
此端点实际提供的内容
https://gateway.pipeworx.io/defillama/mcp 上的 tools/list 会返回上表中的工具,以及 Pipeworx 共享元工具——ask_pipeworx、
discover_tools、search_within、remember/recall 和网关范围内的其余工具。因此,你看到的工具数量会多于此表中的数量:目前,单个工具包端点除了列出自身工具外,还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围,是当日权威的说明。
这是有意为之,并非意外的多路复用。元工具可让受限连接回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——无需你再添加第二个 MCP 服务。目前无法挂载不包含这些元工具的工具包端点;如果额外的架构定义消耗的上下文比路由带来的价值更多,请改为连接一次完整网关,而不是连接多个工具包端点。
或者连接完整的 Pipeworx 网关,直接列出每个工具包的工具,而不只是此工具包的工具:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
两个 URL 都连接到同一个网关和同样的 1878+ 个数据源。唯一的区别是直接列出哪个工具包的工具;无论连接哪个端点,ask_pipeworx 都能访问所有工具。
没有 MCP 客户端?通过 HTTP 调用
curl -X POST https://gateway.pipeworx.io/v1/tools/defi_tvl_protocols \
-H 'Content-Type: application/json' \
-d '{"search":"aave"}'
首次调用无需账户。检查任意工具:GET https://gateway.pipeworx.io/v1/tools/defi_tvl_protocols。查找工具:使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。
独立运行(无需网关账户)
此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户,也无需经由网关往返:
{
"mcpServers": {
"defillama": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-defillama"]
}
}
}
或者直接运行,以确认服务可以启动:
npx -y @pipeworx/mcp-defillama
它通过 stdin/stdout 使用 MCP 通信,并对 initialize/tools/list/tools/call 作出响应,仅提供此工具包的工具——不包含上述网关连接额外提供的共享元工具。来源相同,工具相同,但没有 ask_pipeworx 路由功能。
使用 ask_pipeworx
无需直接调用工具,你可以用通俗的英语提问—— 这在上方的 pack 端点和完整网关上都适用:
ask_pipeworx({ question: "your question about Defillama data" })
网关会选择合适的工具并自动填入参数。
更多信息
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。