Yahoo Finance MCP Server

<div align="right"> <a href="README.md">English</a> | <a href="README.zh.md">中文</a> </div>

这是一个通过Model Context Protocol (MCP)提供Yahoo Finance全面财务数据的服务器。它允许您检索关于股票的详细信息，包括历史价格、公司信息、财务报表、期权数据和市场新闻。

演示

MCP 工具

该服务器通过Model Context Protocol暴露以下工具：

股票信息

工具	描述
get_historical_stock_prices	获取具有自定义周期和间隔的股票历史OHLCV数据
get_stock_info	获取包括价格、指标和公司详情在内的综合股票数据
get_yahoo_finance_news	获取某只股票的最新新闻文章
get_stock_actions	获取股票分红和拆股历史
get_earnings_calendar	获取特定日期范围内报告收益的公司的收益日历数据

财务报表

工具	描述
get_financial_statement	获取损益表、资产负债表或现金流量表（年度/季度）
get_holder_info	获取主要持有人、机构持有人、共同基金或内部交易信息

期权数据

工具	描述
get_option_expiration_dates	获取可用的期权到期日期
get_option_chain	获取特定到期日期和类型（认购/认沽）的期权链

分析师信息

工具	描述
get_recommendations	获取分析师推荐或升级/降级的历史记录

实际应用案例

使用此MCP服务器，您可以使用Claude进行：

股票分析

• 价格分析： "显示AAPL过去6个月每日间隔的历史股价。"
• 财务健康状况： "获取微软的季度资产负债表。"
• 绩效指标： "特斯拉的股票信息中的关键财务指标是什么？"
• 趋势分析： "比较亚马逊和谷歌的季度损益表。"
• 现金流分析： "显示NVIDIA的年度现金流量表。"

市场研究

• 新闻分析： "获取有关Meta Platforms的最新新闻文章。"
• 机构活动： "显示苹果股票的机构持有人。"
• 内部交易： "特斯拉最近的内部交易是什么？"
• 期权分析： "获取SPY在2024年6月21日到期的认购期权链。"
• 分析师覆盖： "过去3个月内亚马逊的分析师推荐是什么？"

投资研究

• "利用最新的季度财务报表对微软的财务健康状况进行全面分析。"
• "比较可口可乐和百事可乐的分红历史和股票拆分。"
• "分析特斯拉过去一年的机构所有权变化。"
• "生成一份关于苹果股票在30天内到期的期权市场活动报告。"
• "总结过去6个月内科技领域的最新分析师升级和降级。"
• "显示下周报告收益的所有公司。"
• "苹果的下一次收益报告何时安排？"
• "哪些科技公司在6月1日至6月15日之间报告收益？"

需求

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

设置

1. 克隆此仓库：

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

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

   uv venv
   source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
   uv pip install -e .
   

使用

开发模式

您可以通过运行以下命令使用MCP Inspector测试服务器：

uv run server.py

这将启动服务器并允许您测试可用的工具。

与桌面版Claude集成

要将此服务器与桌面版Claude集成：

1. 将桌面版Claude安装到您的本地机器。

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配置文件：

   • macOS:

     {
       "mcpServers": {
         "yfinance": {
           "command": "uv",
           "args": [
             "--directory",
             "/ABSOLUTE/PATH/TO/PARENT/FOLDER/yahoo-finance-mcp",
             "run",
             "server.py"
           ]
         }
       }
     }
     

   • Windows:

     {
       "mcpServers": {
         "yfinance": {
           "command": "uv",
           "args": [
             "--directory",
             "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\yahoo-finance-mcp",
             "run",
             "server.py"
           ]
         }
       }
     }
     

   • 注意：您可能需要在命令字段中放置uv可执行文件的完整路径。您可以通过在MacOS/Linux上运行which uv或在Windows上运行where uv来获取此路径。

4. 重启桌面版Claude

许可证

MIT