Fruit Stand Fund Returns

Fruit Stand Fund Returns — MCP 服务

警告

**已于 2026-10-12 退役。**托管的 Fruit Stand Fund Returns MCP 服务（https://api.fruitstand.dev/mcp） 已关闭，并从 MCP 注册表中移除。以下说明已不再有效。本 存储库仅存档供参考。 Fund Returns 数据集仍可在 Snowflake Marketplace 上获取 — 请参阅 fruitstand.dev/datasets/fund-returns。

为 32,000 多只美国共同基金和 ETF 提供实时滚动及日历年总回报的 MCP 服务。 让 AI 助手按代码比较基金表现 — 无需 Morningstar 或 Bloomberg 合约，提供免费套餐，且与 REST API 使用同一个 API 密钥。

通过 Streamable HTTP 提供托管式远程 MCP · 兼容 Claude、Cursor 及任何 MCP 客户端 · 获取免费 API 密钥

---

快速开始

1. 获取 API 密钥

在 app.fruitstand.dev 注册 — 免费套餐无需提供银行卡。

2. 将客户端指向端点

https://api.fruitstand.dev/mcp

通过 Streamable HTTP 提供远程 MCP，并使用 API 密钥作为 bearer token 进行身份验证。

原生远程 MCP 客户端（Claude 网页版／桌面版“添加自定义连接器”、Cursor 等）— 使用上方的 URL 并添加以下标头：

Authorization: Bearer YOUR_API_KEY

Claude Desktop 配置（claude_desktop_config.json）— 使用 mcp-remote 桥接到远程端点：

{
  "mcpServers": {
    "fruit-stand": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.fruitstand.dev/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

重启客户端后，Fruit Stand 工具便会显示。

Docker — 对于需要 docker 命令的客户端，可将同一桥接程序作为容器运行（使用此存储库的 Dockerfile）：

{
  "mcpServers": {
    "fruit-stand": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "FRUITSTAND_API_KEY", "ghcr.io/fruitstanddev/fruitstand-mcp"],
      "env": { "FRUITSTAND_API_KEY": "YOUR_API_KEY" }
    }
  }
}

该容器仅将 stdio 桥接到 api.fruitstand.dev/mcp — 所有数据均来自托管服务。

3. 提出问题

“比较 SPY、QQQ 和 VTI 的 1 年、5 年及成立以来的回报，并告诉我哪只基金在 2022 日历年的表现最佳。”

助手会调用 batchTrailingReturns 和 batchCalendarReturns 并进行总结。

---

工具

共有六个工具，与 REST API 一一对应。返回值采用小数形式（0.1234 = 12.34%）。

工具	功能	主要输入
searchFunds	搜索／列出基金范围（使用键集分页）	q、type、country、exchange、cursor、limit
getFund	按代码获取基金元数据	code
getTrailingReturns	获取单只基金的滚动回报（最新数据或指定日期的数据）	code、as_of?
batchTrailingReturns	单次调用获取最多 100 只基金的滚动回报	codes[]、as_of?
getCalendarReturns	获取单只基金的日历年回报（最新数据或指定年份的数据）	code、year?
batchCalendarReturns	单次调用获取最多 100 只基金的日历年回报	codes[]、year?

代码采用 SYMBOL.US 格式（例如 SPY.US、VTSAX.US）。

---

关于数据

• **覆盖范围：**约 32,000 只美国共同基金和 ETF。
• **滚动回报：**标准时间段，包含成立以来的总回报（已再投资分配收益）。
• **日历年回报：**每个日历年的全年总回报。
• **数据新鲜度：**每日从同一数据管道刷新，该管道也用于构建 Snowflake Marketplace 上的 Fruit Stand 数据集。
• 方法说明和字段参考：app.fruitstand.dev/api/mcp 和文档。

MCP 工具调用的计量方式与 REST 调用完全相同，并计入每月配额。没有有效套餐的密钥在调用工具时会收到 403 错误。

---

链接

• **获取密钥／定价：**https://app.fruitstand.dev/pricing
• **MCP 配置文档：**https://app.fruitstand.dev/api/mcp
• **REST API 参考：**https://app.fruitstand.dev/api
• **官方网站：**https://fruitstand.dev
• **数据管道／数据集状态：**https://fruitstand.dev/datasets

许可证

MIT — 此仓库包含托管服务的公开文档和连接器元数据；服务实现位于单独的仓库中。