Yahoo Finance MCP Server

社区

通过模型上下文协议（MCP）提供全面的 Yahoo Finance 金融数据。

分类: 其他第 168 / 230
Stars: ★ 361 热门
传输方式: stdio（本地进程）
运行环境: Python 3.11+
凭据: 无需凭据
许可证: MIT
最近提交: 22 天前
工具数: 9

47FMRS · D

该 MCP 服务器提供了丰富的 Yahoo Finance 数据工具，覆盖股票信息、财务报表、期权和分析师推荐。安装简单，通过 uvx 即可运行。适合需要快速获取金融数据的开发者和投资者。但依赖第三方数据源，可能不稳定，且数据准确性需验证。

最强项 · 安装易用性 13/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

8/20

维护活跃度

9/20

文档质量

12/20

安装易用性

13/20

查看各项评分依据

可靠性 5/20: 提供的材料只有README和仓库元数据，没有server.py、pyproject.toml或测试代码，因此无法验证MCP初始化/工具列表握手以及工具名称和参数是否与声明一致。README列出的9个工具没有配合可复现执行证据；既无CI也无提交测试，只能按‘快乐路径可能成立但证据薄弱’保守给分。
安全与权限 8/20: 依据README，这是只读金融数据服务，未涉及任何凭证、密钥或破坏性操作，主要数据边界是对Yahoo Finance发起网络请求。扣分原因是未提供源码审计证据，也没有声明权限/网络策略、依赖风险或对用户输入（ticker）的校验方式，因此不能给出更高分数。
维护活跃度 9/20: 仓库未归档、许可证明确为MIT，且有英文和中文README。但所提供的材料中缺少发布版本、提交活跃度、issue响应、依赖更新记录或安全响应渠道，只有许可证和未归档状态不足以证明持续维护，因此落在‘活跃但治理/版本信息不全’区间。
文档质量 12/20: README覆盖了工具列表、真实场景示例、Python版本要求、uvx安装、本地开发以及Claude Desktop配置示例，整体可用。扣分点包括：无各工具的完整参数说明、无速率/配额限制说明、无错误排查指南、无成本或依赖细节，且无法确认中文README是否同等完整。
安装易用性 13/20: 文档提供了清晰的启动路径：通过uvx从Git仓库直接运行，或本地用uv安装；还给出了macOS/Windows的Claude Desktop配置JSON示例。由于提供的文件中没有可验证的CI或自动化安装测试，且基于Git的远程安装可能因Python/平台版本而脆弱，按静态校准要求不超过15分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要快速获取 Yahoo Finance 数据的开发者和投资者
使用 Claude 进行财务分析、市场研究和投资研究的人员
希望将财务数据集成到 MCP 客户端工作流程中的用户

不适合谁

需要实时或超低延迟数据的场景（数据来自 Yahoo Finance，可能延迟）
需要官方、权威或经过验证的财务数据的场景（数据来自 Yahoo Finance，可能不完整或不准确）
需要长时间稳定运行的服务器，因为依赖第三方 Yahoo Finance API，可能不稳定

所需权限

无需 API 密钥或额外权限，直接访问 Yahoo Finance 公共数据。
通过标准 I/O 与 MCP 客户端通信。
网络访问 Yahoo Finance 以获取数据。

风险与副作用

依赖第三方 Yahoo Finance 服务，可能因服务中断或 API 变化导致数据不可用。
数据可能延迟或不准确，用于投资决策需谨慎。
存在速率限制，高频率调用可能导致请求被拒绝。

安装接入

准备工作

运行环境：Python 3.11+

确保已安装 Python 3.11 或更高版本。
使用 uvx 直接运行：uvx --from git+https://github.com/Alex2Yang97/yahoo-finance-mcp yahoo-finance-mcp。
或者克隆仓库并本地安装：git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git，进入目录，创建虚拟环境并安装依赖。
对于 Claude Desktop，编辑配置文件，添加上述 MCP 服务器配置，然后重启 Claude Desktop。

claude_desktop_config.json

{
  "mcpServers": {
    "yfinance": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Alex2Yang97/yahoo-finance-mcp",
        "yahoo-finance-mcp"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "yfinance": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Alex2Yang97/yahoo-finance-mcp",
        "yahoo-finance-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add yfinance -- uvx --from git+https://github.com/Alex2Yang97/yahoo-finance-mcp yahoo-finance-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude for Desktop 配置中添加 yfinance 服务器并重启后，工具列表中应出现 get_stock_info 等工具；询问“AAPL 的当前股价是多少”若能返回数据即说明连接成功。

常见排障

确保网络连接正常，能够访问 Yahoo Finance。
确保 Python 版本符合要求（3.11+）。
检查是否正确安装依赖，特别是 yfinance 和 mcp。
对于 Claude Desktop，确保 uvx 命令在 PATH 中，或使用绝对路径。
如果工具无输出，尝试重新启动 MCP 服务器。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

显示 AAPL 过去 6 个月的每日历史股价
获取微软的季度资产负债表
获取 SPY 到期日为 2024-06-21 的看涨期权链
查询亚马逊最近的分析师评级建议

工具能力 9

get_historical_stock_prices 只读

获取股票的历史OHLCV数据，可自定义周期和间隔。

get_stock_info 只读

获取全面的股票数据，包括价格、指标和公司详情。

get_yahoo_finance_news 只读

获取股票的最新新闻文章。

get_stock_actions 只读

获取股票的股息和拆股历史。

get_financial_statement 只读

获取损益表、资产负债表或现金流量表（年度/季度）。

get_holder_info 只读

获取主要持有人、机构持有人、共同基金或内部交易。

get_option_expiration_dates 只读

获取可用的期权到期日期。

get_option_chain 只读

获取特定到期日和类型（看涨/看跌）的期权链。

展开其余 1 个工具

get_recommendations 只读

获取分析师推荐或升级/降级历史。

使用场景

获取 AAPL 过去 6 个月的每日历史股价。

获取微软的季度资产负债表。

获取特斯拉的关键财务指标。

比较亚马逊和谷歌的季度损益表。

获取英伟达的年度现金流量表。

获取 Meta Platforms 的最新新闻。

查看苹果股票的机构持有人。

查询特斯拉最近的内部交易。

获取 SPY 的看涨期权链（到期日 2024-06-21）。

查看亚马逊最近 3 个月的分析师推荐。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

这是一个模型上下文协议（MCP）服务器，提供来自 Yahoo Finance 的全面金融数据。它允许您检索关于股票的详细信息，包括历史价格、公司信息、财务报表、期权数据和市场新闻。