yfinance-mcp

为你的 AI 提供实时市场数据。 一个 Model Context Protocol 服务器，为 Claude（或任何 MCP 客户端）提供实时报价、OHLCV 历史数据、完整期权链、新闻以及多标的对比。免费，无需 API 密钥。

为什么

LLM 回答市场问题时依赖的是训练数据的猜测。只需接入这个服务器一次，它们就不再猜测了：

• "苹果现在股价多少？" → 实时报价，而不是过时的幻觉

• "拉取下个月到期的 AAPL 期权" → 带 IV 和未平仓量的真实行权价

• "今年 NVDA 对比 AMD 对比 INTC？" → 基于数据计算的实际收益率、波动率、回撤

• "PLTR 最近有什么新闻？" → 带链接的标题，可供引用

Related MCP server: yfinance

工具

响应为 JSON，截断为适合 LLM 的大小（期权每侧上限 60 行），并附带汇总统计，让模型在查看原始 K 线之前先基于聚合数据进行推理。

安装

git clone https://github.com/saksham10arora-dotcom/yfinance-mcp
cd yfinance-mcp
python3 -m venv .venv && .venv/bin/pip install fastmcp yfinance

Claude Desktop / 任何 MCP 客户端

添加到 claude_desktop_config.json（文件 → 设置 → 开发者 → 编辑配置）：

{
  "mcpServers": {
    "yfinance": {
      "command": "/absolute/path/to/yfinance-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/yfinance-mcp/server.py"]
    }
  }
}

重启 Claude Desktop。工具会出现在 🔨 图标下。询问任意股票代码即可。

无需 MCP 客户端即可验证

./.venv/bin/python -c "import server; print(server.get_quote('AAPL'))"

CI 在每次推送时都会运行与 GitHub 相同的 stdio 握手测试，因此 main 分支始终保证协议正确。

常见问题

数据是实时的吗？ Yahoo Finance 数据：美股接近实时，部分国际市场有延迟。适合研究和聊天，不适合下单执行。

需要付费吗？ 不需要。无需 API 密钥、无需限流账户、无需任何配置。

为什么不直接把 yfinance 代码粘贴到聊天里？ 当然可以。这个服务器省去了复制粘贴的循环，让模型根据问题自行决定调用哪个工具，包括多步骤问题（"对比这五只股票，然后拉取波动率最大的那只看涨期权链"）。

Windows 支持吗？ 支持。将配置指向 .venv\Scripts\python.exe，并在 JSON 中使用双反斜杠。

故障排查

• 重启后工具图标消失：配置中的路径必须是绝对路径；相对路径会静默失败。

• no data for <ticker>：股票已退市或代码拼写错误；请在浏览器中到 Yahoo Finance 确认。

• 大量使用后被限流：等待几分钟再试；Yahoo 会限制突发请求。

替代方案对比

许可证

MIT。不构成投资建议；读取你投资组合的 AI 不是受托人。