Web3Juice

web3juice-mcp

为 AI 助手提供有证据支持的 DeFi 收益数据。 询问 Claude、Cursor 或任何 MCP 客户端，约 17,000 个 DeFi 池的收益是多少、收益来自哪里（基础代币还是奖励代币）、过去 90 天如何变化，以及各池之间有何差异—— 每个数字都标注了日期并链接到来源。

此软件包是一个精简且零依赖的桥接程序，可将本地 stdio MCP 客户端连接到托管的 Web3Juice MCP 服务： https://web3juice.com/api/mcp。支持远程服务的客户端可以直接连接到该 URL；请参阅 web3juice.com/mcp。

只读：它不会接触钱包密钥、签署交易或转移资金。非财务建议。

快速开始

Claude Desktop → 设置 → 开发者 → 编辑配置，然后添加：

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

重启 Claude Desktop 并询问：“各条链上的 USDC 借贷目前收益是多少？”

需要 Node.js 18.17 或更高版本。

使用 API 密钥（更高限额，Pro 版可使用自己的提醒和笔记本）

在你的 Web3Juice 账户页面创建密钥，并将其添加为环境 变量：

{
  "mcpServers": {
    "web3juice": {
      "command": "npx",
      "args": ["-y", "web3juice-mcp"],
      "env": {"WEB3JUICE_API_KEY": "w3j_your_key_here"}
    }
  }
}

其他客户端

Claude Code（远程，无需安装）：

claude mcp add --transport http web3juice https://web3juice.com/api/mcp

Claude Code 插件（此代码库同时也是一个插件市场）：

claude plugin marketplace add jimbob1414/web3juice-mcp

claude plugin install web3juice@web3juice

在环境中设置 WEB3JUICE_API_KEY，即可使用自己的限额。

Cursor、VS Code、ChatGPT、Claude.ai 等： 请参阅 web3juice.com/mcp。

Claude Desktop 扩展： 从最新版本下载 web3juice.mcpb 并打开。

工具

工具	功能
summarize_yields	按任意筛选条件查看市场概览：按链、协议或策略划分的中位 APY 和 TVL 加权 APY。
search_pools	按代币、链、协议、APY 和 TVL 查找并排序资金池。
get_pool	查看单个资金池：APY 构成、TVL、数据时效、合约和代币地址、存款与来源链接、评估。
get_pool_history	查看 7/30/90 天 APY 趋势及标注日期的样本。
compare_pools	并排比较 2–5 个资金池及其 30 天区间。
get_data_sources	查看数据源运行状况和最近更新时间。
get_methodology	了解实验性证据评估的工作原理。

使用 Pro、Power 或 Team 密钥时，还会提供只读工作区工具：list_alerts、get_alert、 list_notebook_entries、get_notebook_entry、list_investments、list_wallets、get_wallet_positions。

提示词：find_stablecoin_yields、analyse_pool、compare_yields、yield_market_snapshot。 资源：web3juice://guide、web3juice://methodology、web3juice://data-sources、web3juice://pool/{poolId}。

限额和定价

	无密钥	免费账户密钥	Pro（£10/月）	Power（£39/月）
每日调用次数	每个地址 500 次	500 次	10,000 次	50,000 次
每分钟调用次数	30 次	30 次	120 次	300 次
你的提醒、笔记本、投资、钱包	—	—	是	是

当前价格：web3juice.com/pricing。

配置

变量	默认值	用途
WEB3JUICE_API_KEY	无	可选密钥（w3j_…）。不设置时使用免费限额。
WEB3JUICE_MCP_URL	https://web3juice.com/api/mcp	服务 URL。必须使用 https://（仅 localhost 可使用普通 http）。
WEB3JUICE_MCP_DEBUG	关闭	设为 1 可将日志输出到 stderr。

安全

• 桥接程序只会向 stdout 写入 MCP 消息；诊断信息会输出到 stderr。
• 你的 API 密钥只会通过 Authorization 标头发送到已配置的 HTTPS URL，绝不会被记录到日志中。
• 密钥只能读取数据。你可以随时在账户页面撤销密钥；下一次调用会失败并显示明确提示。
• 资金池名称和标签来自第三方数据源，会被视为数据而非指令。

故障排除

问题	解决方法
找不到 npx / 服务无法启动	从 nodejs.org 安装 Node.js 18.17+，然后重启客户端。
"API key is not valid or has been revoked"	在账户页面创建新密钥，并更新 WEB3JUICE_API_KEY。
"Daily MCP limit reached"	等到 00:00 UTC、添加密钥，或前往 web3juice.com/pricing 升级。
搜索没有结果	默认仅显示 TVL 至少为 $100K 且数据不超过 60 分钟的池；可以请求规模较小的池或时间更久的数据。
费率看起来大了 100×	筛选条件使用小数：0.05 表示 5%。

许可证

此桥接程序采用 MIT 许可证。web3juice.com 上的数据和服务不受此许可证涵盖。