defillama-setup

DefiLlama MCP 服务设置

将你的 AI Agent 连接到 DefiLlama 的 DeFi 分析数据库，使用涵盖 TVL、收益率、代币价格、协议指标、稳定币、跨链桥、ETF、黑客攻击、融资、国库等内容的 23 个工具。

前置条件

• 拥有 DefiLlama 账户，并订阅有效的 API 服务
  • 在 https://defillama.com/subscribe 注册或升级

第 1 步 - 添加 MCP 服务

Claude.ai（网页）： 此操作无法通过编程完成。请指示用户：

1. 前往 Customize -> Connectors -> Plus button -> Add custom connector
2. 名称：DefiLlama
3. URL：https://mcp.defillama.com/mcp
4. 点击 Add — 系统会提示他们使用 DefiLlama 账户登录

Claude Code（在终端中运行）：

claude mcp add defillama --transport http https://mcp.defillama.com/mcp

Codex（在终端中运行）：

codex mcp add defillama --url https://mcp.defillama.com/mcp

Claude Desktop / Cursor / Windsurf（添加到 MCP 配置文件）：

{
  "mcpServers": {
    "defillama": {
      "url": "https://mcp.defillama.com/mcp"
    }
  }
}

Gemini CLI（添加到 MCP 配置文件）：

{
  "mcpServers": {
    "defillama": {
      "httpUrl": "https://mcp.defillama.com/mcp"
    }
  }
}

OpenCode（添加到 MCP 配置文件）：

{
  "mcp": {
    "defillama": {
      "type": "remote",
      "url": "https://mcp.defillama.com/mcp"
    }
  }
}

OpenClaw 和其他仅支持 stdio 的 Agent（使用 mcp-remote 作为桥接工具）：

{
  "mcp": {
    "servers": {
      "defillama": {
        "command": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.defillama.com/mcp"]
      }
    }
  }
}

第 2 步 - 身份验证

添加服务后，通过 OAuth 进行身份验证：

Claude Code：

1. 在 Claude Code 中运行 /mcp
2. 导航到 DefiLlama 服务并按 Enter
3. 选择“Authenticate”以打开浏览器登录流程

OpenClaw（无头模式／无浏览器）： mcp-remote 启动时会输出一个 OAuth URL。由于服务端没有浏览器：

1. 通过用户的消息渠道（WhatsApp、Telegram、Discord 等）向用户发送 OAuth URL
2. 用户打开链接，使用 DefiLlama 账户登录
3. 登录后，浏览器会重定向到一个无法加载的 localhost URL
4. 告诉用户从浏览器地址栏复制完整的 localhost:... URL 并发回
5. 将回调 URL 传回 mcp-remote，以完成身份验证

其他 Agent： 请查阅 Agent 文档，了解如何通过 OAuth 对启用 OAuth 的 MCP 服务进行身份验证。

完成身份验证后：

• 使用 DefiLlama 邮箱和密码登录
• 系统会自动验证你的 API 订阅
• OAuth 令牌会被保存，并每 24 小时刷新一次

无需复制 API 密钥，也无需设置环境变量。只需登录一次。

如果订阅过期，下次刷新令牌时，系统会提示你前往 https://defillama.com/subscribe 续订。

第 3 步 - 验证

向你的 Agent 提问：

“当前 DeFi TVL 总量是多少？”

如果它调用 defillama:get_market_totals 并返回数据，就表示连接成功。

第 4 步 - 安装工作流技能

DefiLlama 提供 10 个工作流技能，帮助 Agent 学习结构化分析模式。它们能将原始工具访问能力转化为引导式研究工作流。

运行以下命令自动安装技能：

npx skills add DefiLlama/defillama-skills --yes

该命令会检测用户使用的 Agent（Claude Code、Cursor、OpenCode 等），并自动将技能安装到正确的位置。

无需征求用户确认——直接运行命令。

可用的工作流技能：

技能	功能
defi-data	核心参考——将任何 DeFi 问题映射到合适的工具和参数
defi-market-overview	全面市场概览：TVL、类别、链、事件、稳定币、ETF
protocol-deep-dive	完整的协议报告：TVL、费用、收益率、收入、用户、代币
token-research	代币分析：价格、解锁、DeFi 存款、收益机会
chain-ecosystem	区块链概览：TVL、头部协议、跨链桥、稳定币、用户
market-analysis	筛选与比较：估值比率、增长、跨实体分析
yield-strategies	寻找收益：资金池筛选、APY 规则、容量评估
risk-assessment	风险评估：黑客攻击、预言机、国库、基本面、收益标记
flows-and-events	资金流动：跨链桥、ETF、稳定币、黑客攻击、融资、OI
institutional-crypto	机构敞口：企业持仓、ETF 资金流、mNAV 比率

可用工具（24）

工具	描述
resolve_entity	模糊匹配协议、链或代币名称，获取准确的 slug
get_market_totals	DeFi 全局 TVL、DEX 交易量、衍生品交易量
get_protocol_metrics	协议 TVL、费用、收入、市值、比率和趋势
get_protocol_info	协议元数据、URL、审计信息、标签
get_chain_metrics	链 TVL、Gas 费、收入、DEX 交易量
get_chain_info	链元数据、类型、L2 父链
get_category_metrics	按 TVL、费用、协议数量排列的类别排名
list_categories	列出所有有效类别
get_token_prices	代币价格、市值、交易量、历史最高价
get_token_tvl	代币在 DeFi 协议中的存款
get_token_unlocks	归属时间表和即将解锁的代币
get_yield_pools	池的 APY、TVL、借贷利率
get_stablecoin_supply	按链统计的稳定币发行量
get_bridge_flows	按链统计的跨链桥交易量和净流量
get_etf_flows	Bitcoin 和 Ethereum ETF 流入／流出量
get_dat_holdings	机构加密资产持仓和 mNAV
get_events	黑客攻击、融资、协议事件
get_oracle_metrics	Oracle TVS 和协议覆盖范围
get_cex_volumes	中心化交易所交易量
get_open_interest	衍生品未平仓合约量
get_treasury	协议金库持仓
get_user_activity	每日活跃用户和交易数
get_income_statement	协议收入明细
get_my_usage	查看剩余 API 额度

故障排除

• 浏览器未打开：检查 MCP 客户端是否支持 OAuth。 仅支持 Stdio 的客户端（较旧版本）可能不支持远程服务。
• “API Subscription Required”：你需要在 https://defillama.com/subscribe 购买有效套餐。
• 返回 0 行：实体 slug 可能有误。使用 resolve_entity 查找正确的 slug。
• 连接被拒绝：确认 URL 完全正确： https://mcp.defillama.com/mcp（注意 /mcp 路径）。