Yahoo Finance MCP Server

Yahoo Finance MCP 服务

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

演示

MCP 工具

该服务通过模型上下文协议提供以下工具：

股票信息

工具	描述
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	获取指定到期日期和类型（看涨／看跌）的期权链

分析师信息

工具	描述
get_recommendations	获取分析师评级或评级上调／下调历史

实际应用场景

借助此 MCP 服务，你可以使用 Claude：

股票分析

• 价格分析：“显示 NOW 过去 6 个月的历史股价，按日间隔统计。”
• 财务状况：“获取 Intuit 的季度资产负债表。”
• 绩效指标：“Intuit 的股票信息中有哪些关键财务指标？”
• 趋势分析：“比较 ServiceNow 和 Intuit 的季度损益表。”
• 现金流分析：“显示 ServiceNow 的年度现金流量表。”

市场研究

• 新闻分析：“获取有关 Intuit 的最新新闻文章。”
• 机构活动：“显示 NOW 股票的机构持有人。”
• 内幕交易：“ServiceNow 最近有哪些内幕交易记录？”
• 期权分析：“获取到期日为 2026-01-30 的 INTU 看涨期权链。”
• 分析师覆盖：“过去 3 个月，分析师对 Intuit 有哪些评级？”

投资研究

• “根据 Intuit 最新的季度财务报表，对其财务状况进行全面分析。”
• “比较 Coca-Cola 和 PepsiCo 的分红历史和股票拆分情况。”
• “分析 ServiceNow 过去一年机构持股的变化。”
• “生成一份报告，分析 30 天后到期的 Intuit 股票期权市场活动。”
• “总结过去 6 个月科技行业最新的分析师评级上调和下调情况。”

要求

• Python 3.14.6 或更高版本
• pyproject.toml 中列出的依赖项，包括：
  • mcp
  • yfinance
  • pandas
  • pydantic
  • 以及其他用于数据处理的软件包

设置

推荐：使用 uvx 运行

无需创建本地虚拟环境，即可直接从代码仓库运行服务：

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

本地开发

1. 克隆此代码仓库：

   git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
   cd yahoo-finance-mcp
   

2. 创建并激活虚拟环境，然后安装依赖项：

   uv sync
   

使用方法

快速开始

使用以下命令运行打包后的入口点：

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

如需在此检出版本中应用本地更改，请使用：

uvx --from . yahoo-finance-mcp

开发模式

如果你正在本地克隆版本中工作，并希望直接运行源代码目录：

uv run server.py

与 Claude for Desktop 集成

要将此服务与 Claude for Desktop 集成：

1. 在本地计算机上安装 Claude for Desktop。

2. 在本地计算机上安装 VS Code。然后运行以下命令打开 claude_desktop_config.json 文件：

   • MacOS：code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows：code $env:AppData\Claude\claude_desktop_config.json

3. 编辑 Claude for Desktop 配置文件，文件位置如下：

   • macOS：

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

   • Windows：

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

   • 注意：你可能需要在 command 字段中填写 uv 可执行文件的完整路径。你可以在 MacOS/Linux 上运行 which uv，或在 Windows 上运行 where uv 来获取该路径。

4. 重启 Claude for Desktop

许可证

MIT