DefiLlama MCP Server Setup 是一个安装与配置类技能，用于把 AI 智能体接入 DefiLlama 的 DeFi 分析数据库。接入后可使用 23 个工具，覆盖 TVL、收益率、代币价格、协议指标、稳定币、跨链桥、ETF、黑客事件、融资、国库等数据。
一、前置条件 需要一个拥有有效 API 订阅的 DefiLlama 账户。可在 https://defillama.com/subscribe 注册或升级。
二、第一步：添加 MCP 服务器 不同客户端的添加方式如下：
Claude.ai（网页端）：无法通过程序完成，需手动操作。进入 Customize -> Connectors -> 加号按钮 -> Add custom connector；名称填 DefiLlama；URL 填 https://mcp.defillama.com/mcp；点击 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 的智能体（使用 mcp-remote 作为桥接）： { "mcp": { "servers": { "defillama": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.defillama.com/mcp"] } } } }
三、第二步：认证 添加服务器后，通过 OAuth 认证：
Claude Code：在 Claude Code 内运行 /mcp；导航到 DefiLlama 服务器并按回车；选择 "Authenticate" 打开浏览器登录流程。
OpenClaw（无头/无浏览器）：当 mcp-remote 启动时，会输出一个 OAuth URL。由于服务器上没有浏览器：通过用户的消息渠道（WhatsApp、Telegram、Discord 等）把 OAuth URL 发送给用户；用户打开链接，使用 DefiLlama 账户登录；登录后浏览器会重定向到一个无法加载的 localhost URL；让用户从浏览器地址栏复制完整的 localhost:... URL 并发回；将回调 URL 传回 mcp-remote 以完成认证。
其他智能体：查阅对应智能体文档，了解如何对支持 OAuth 的 MCP 服务器进行认证。
认证完成后：使用 DefiLlama 邮箱和密码登录；API 订阅会自动验证；OAuth 令牌会被存储，并每 24 小时刷新一次。无需复制 API 密钥，无需设置环境变量，只需登录一次。如果订阅失效，下次令牌刷新时会提示前往 https://defillama.com/subscribe 续订。
四、第三步：验证 向智能体提问："What is the current total DeFi TVL?" 如果它调用 defillama:get_market_totals 并返回数据，说明已连接成功。
五、第四步：安装工作流技能 DefiLlama 提供 10 个工作流技能，教智能体结构化的分析模式，把原始工具访问转化为有引导的研究工作流。
自动安装命令： npx skills add DefiLlama/defillama-skills --yes
该命令会检测用户的智能体（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、稳定币、黑客、融资、未平仓合约。 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：比特币和以太坊 ETF 流入/流出。 get_dat_holdings：机构加密持仓和 mNAV。 get_events：黑客事件、融资、协议事件。 get_oracle_metrics：预言机 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 路径）。