YieldCave

YieldCave

面向 AI Agent 的机器可读代币化金融数据：代币化国债、稳定币收益平台和代币化股票。

YieldCave 是一个 MCP 服务。将它添加到 Claude Desktop、Claude Code 或 Cursor 后，您的 Agent 就能回答这类问题：

• “现在 Solana 上有哪些代币化美国国债？收益率是多少？”
• “与我 0.4% 的储蓄账户相比，将 25,000 美元存入收益最高的流动性代币化国债能多赚多少？”
• “总结代币化 RWA 市场。”
• “USDC 在哪个抵押借贷市场上的收益最高，且该市场的资金至少有 5,000 万美元？”
• “哪种代币化 NVIDIA 代币的流动性最高？它的交易价格是否高于股票价格？”

它是只读的。它不会接触钱包，不会转移资金，也不会提供建议。这正是它的定位：一个索引，而非经纪商。

数据来自 DefiLlama 的公共 API。无需 API 密钥。

1. 在本地运行（5 分钟）

需要 Node 20 或更高版本（node --version）。

cd ~/yieldcave && npm install

在终端中查看数据：

npm run demo

运行单元测试（无需网络）：

npm test

运行端到端检查：启动真实的 MCP 服务，并通过 stdio 和 HTTP 按照 Claude 的调用方式进行调用：

npm run smoke && npm run smoke:http

2. 添加到 Claude Desktop

打开此文件（如果不存在，请创建）：

~/Library/Application Support/Claude/claude_desktop_config.json

在 mcpServers 下添加 YieldCave。如果文件中已有其他服务，只需在现有对象中添加 "yieldcave" 代码块。

{
  "mcpServers": {
    "yieldcave": {
      "command": "node",
      "args": ["/Users/bjf/yieldcave/src/server.js"]
    }
  }
}

退出并重新打开 Claude Desktop。您应该会看到一个工具图标，其中包含四个 YieldCave 工具。试试：“使用 YieldCave 总结代币化国债市场。”

3. 添加到 Claude Code

claude mcp add yieldcave -- node /Users/bjf/yieldcave/src/server.js

3b. 在浏览器中的 claude.ai 使用（托管版本）

YieldCave 也运行在 Supabase 云端，因此 claude.ai（以及其他任何人）都能访问它，无需让您的 Mac 保持开机。

https://mcp.yieldcave.com

在 claude.ai 中：Customize → Connectors → Add → Add custom connector → 粘贴该 URL，无需登录。托管版本从 Postgres 提供数据，由计划任务每小时刷新一次，并且每天保留一个快照。这些历史记录为第五个工具 rwa_history 提供支持。

托管版本的构成如下，所有内容都位于 supabase/ 文件夹中：

supabase/functions/_shared/   the real code: data.js, tools.js, mcp.js (src/ re-exports these)
supabase/functions/mcp/       public MCP endpoint, reads market_latest and snapshots from Postgres
supabase/functions/refresh/   fetches DefiLlama + CoinGecko + quotes, writes market_latest + today's snapshot, fires alerts; needs REFRESH_SECRET header
supabase/functions/enrich/    fills chain metadata for tokenized equities, 15 per run, every 10 minutes
supabase/functions/stripe-webhook/  upgrades/downgrades keys on Stripe events
supabase/functions/site/      serves the landing page (pages.js is generated from site/)
supabase/migrations/          tables (market, snapshots, alerts, api_keys, usage_daily), RLS on, hourly pg_cron job, public site bucket
scripts/                      configure-stripe.sh, publish-site.sh

更改后重新部署：

supabase functions deploy mcp --no-verify-jwt --use-api && supabase functions deploy refresh --no-verify-jwt --use-api

端到端检查部署（工具、历史记录，以及一个会创建、触发并自行删除的警报）：

set -a; source .env.local; set +a; YIELDCAVE_URL=https://ccvhvxbqtvqbhexhrjnj.supabase.co/functions/v1/mcp npm run smoke:remote && npm run smoke:alerts

密钥（数据库密码、刷新密钥）保存在 .env.local 中，Git 会忽略此文件。切勿提交这些密钥。

4. 工具

工具	返回内容
list_rwa_yields	代币化 RWA 部署及其 APY 和 TVL。可按 chain、kind（treasury 或 other_rwa）、minTvlUsd 筛选；按 tvlUsd 或 apy 排序
get_rwa_asset	获取某个代币符号（例如 BUIDL）在所有链上的信息，包括 TVL 总额和精选描述
list_stablecoin_yields	借贷、金库、信贷和基差平台上的单一资产稳定币池（USDC、USDT、DAI、USDe 等），每个池均标注分组，并提供基础 APY、奖励 APY、30 天均值和 TVL。默认最低门槛为 1,000 万美元
stablecoin_yield_summary	按稳定币列出：平台、TVL、中位 APY、总体最佳平台和最佳抵押借贷平台；按组汇总；并提供代币化国债中位数以供比较
list_tokenized_equities	代币化股票、IPO 前股份和 ETF（xStocks、bStocks、Ondo、Robinhood、Dinari、Coinbase 等）：价格、市值、交易量、标的代码、相对标的报价的溢价／折价、所在链。数据来源：CoinGecko；报价来自 Yahoo 图表数据
get_tokenized_equity	获取某个标的（例如 TSLA）在所有包装代币中的信息：发行方、所在链、流动性最高的代币、溢价区间
tokenized_equity_summary	总量，按发行方和类型划分的汇总，主要标的，溢价统计
rwa_market_summary	总量：不同国债代币的数量、TVL、中位 APY、前五名，以及其他 RWA 的总量
compare_yield_to_tokenized_treasuries	简单利息计算：在指定时间范围内，将当前 APY 与流动性最佳的代币化国债进行比较，并明确列出假设
rwa_issuer_terms	精选整理的 BUIDL、USYC、USDY、OUSG、USTB、TBILL、STBT、BENJI 条款：结构、资格要求（美国人士？）、最低金额、赎回、费用、来源、核实日期
rwa_history	某个代币符号过去 N 天的每日 TVL 和按 TVL 加权的 APY，以及变动情况。universe 为 rwa 或 stablecoin。托管版：来自 Postgres 快照。本地版：来自 npm run snapshot 生成的文件
rwa_changes	查看过去 N 天以来的变动：每个部署的 APY 和 TVL 变化、新增和消失的部署（托管版可用；本地版需有快照）
create_alert、list_alerts、delete_alert	仅托管版可用，需提供密钥。规则示例：“任一国债 APY 高于 4.5”或“USDY TVL 低于 10 亿美元”。每小时检查一次；向你的 HTTPS Webhook（Slack、Discord、Zapier 或你的服务）发送 JSON POST，每 24 小时最多一次
create_api_key、my_usage、upgrade、manage_subscription	仅托管版可用。通过电子邮件获取免费密钥（仅显示一次）、查看套餐和用量、获取 Pro 结账链接，以及用于更改或取消订阅的 Stripe 账单门户链接

4b. 方案、密钥与用量计量（托管版）

方案	价格	每日调用次数	警报	历史记录	变更	稳定币平台	发行方条款	代币化股票
匿名	$0	每个 IP 100 次	0	7 天	回溯 1 天	借贷和金库，10 行	摘要	10 行，无溢价
免费密钥	$0	300 次	3	7 天	回溯 1 天	借贷和金库，10 行	摘要	10 行，无溢价
Pro	$49/月	5,000 次	100	全部	任意范围	所有组别，100 行	含来源的完整记录	100 行，包含溢价和溢价排序

实时数据免费；深度数据付费。让你的 Agent 使用你的邮箱调用 create_api_key 来获取密钥；通过 x-api-key 标头（或 Authorization: Bearer）发送密钥，或者在 claude.ai 的连接器 URL 中使用 ?key=yc_...。使用 upgrade 工具购买 Pro（通过 Stripe 结账），并通过 manage_subscription 管理。自托管服务没有方案限制。

使用密钥设置 claude.ai。 claude.ai 中的自定义连接器无法发送请求标头，因此密钥需放入 URL：添加自定义连接器，使用 https://mcp.yieldcave.com/?key=yc_your_key，并选择“无需登录”。如果两者都存在，标头（x-api-key 或 Authorization: Bearer）优先。服务端绝不会记录查询字符串或密钥。请将 URL 视为机密，因为持有该 URL 的任何人都能使用密钥。

每个 tools/call 都会在 usage_daily 表中计数，关联到相应密钥；匿名调用则关联到经过哈希处理的 IP。限制在 UTC 午夜重置。密钥以 SHA-256 哈希形式存储；明文密钥只会返回一次，之后不再显示。警报归创建它们的密钥所有者所有。以上逻辑均位于 supabase/functions/mcp/index.ts；限制本身则定义在 supabase/functions/_shared/plans.js 中。

启用付款需要一个 Stripe 账户和三个值。创建一个每月 $49 的定期产品，为 https://ccvhvxbqtvqbhexhrjnj.supabase.co/functions/v1/stripe-webhook 添加 webhook 端点，并订阅以下事件：checkout.session.completed、customer.subscription.deleted、customer.subscription.updated，然后运行：

./scripts/configure-stripe.sh sk_live_... price_... whsec_...

在此之前，upgrade 会返回礼貌提示：“付款功能尚未启用”。结账完成后，webhook 会将密钥升级为 Pro；订阅结束时则会降级；manage_subscription 会打开 Stripe 账单门户（返回 URL 为 https://yieldcave.com）。结账成功页和取消页分别是 https://yieldcave.com/thanks 和 https://yieldcave.com；如有需要，可通过 SITE_URL secret 覆盖这两个页面。

落地页为 https://yieldcave.com，托管在 Cloudflare 上（Workers 静态资源，即 Cloudflare Pages 的当前形式）。编辑 site/*.html，然后使用 ./scripts/publish-site.sh 发布，该脚本会运行 wrangler pages deploy（需先一次性运行 npx wrangler login）。site Edge Function 是相同页面的备用副本，未从任何地方链接到。

每个响应都包含免责声明和数据获取时间。发行方条款由人工维护在 supabase/functions/_shared/issuers.js 中，并附有 verifiedOn 日期和来源 URL；条款变更时请更新该文件。

5. 项目布局

src/data.js     re-export of supabase/functions/_shared/data.js (fetch, normalize, cache, local snapshots, equities)
src/equities.js re-export of _shared/equities.js: tokenized stock parsing and tools
src/tools.js    re-export of _shared/tools.js: pure functions behind each tool (unit-tested)
src/mcp.js      re-export of _shared/mcp.js: declares the five tools
src/snapshot.js saves today's market locally (npm run snapshot)
src/server.js   stdio entry point: Claude Desktop, Claude Code, Cursor
src/http.js     HTTP entry point: claude.ai custom connectors, remote clients
src/demo.js     prints a summary table in the terminal
test/           unit tests (node --test) and a live smoke test
site/           landing page with a live table (npm run site, then open http://localhost:8080)

6. 工作原理：面向 API 新手

API 是一个返回数据而非网页的 URL。在浏览器中打开 https://yields.llama.fi/pools，就能看到约 16,000 个收益池的原始 JSON。src/data.js 会下载这些数据，只保留 DefiLlama 归类为现实世界资产的池，并将每个池整理为 12 个名称清晰的字段。

MCP 是一种小型协议，可让 AI 模型调用你定义的函数。src/server.js 会告诉模型“这里有四个函数，每个参数的含义如下”；当模型决定调用其中一个时，服务端会运行 src/tools.js 中对应的函数并返回 JSON。Claude 会读取该 JSON，并用英文撰写答案。

服务端通过 stdio（标准输入/输出）通信，因此其中禁止使用 console.log：任何打印到 stdout 的内容都会破坏协议数据流。调试时请使用 console.error。

7. 后续步骤

托管端点、历史记录、发行方条款、Webhook 提醒、API 密钥和计量功能均已上线。启用 Pro 只需一个 Stripe 账户。接下来会添加自定义域名和更多资产类别（代币化股票）。

免责声明

仅供参考，不构成财务建议。数据来自公开的第三方来源，可能有所延迟或存在错误。采取行动前，请向发行方核实。

许可证

MIT