Yahoo Finance MCP 服务器

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

这是一个模型上下文协议 (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 来：

股票分析

• 价格分析: "显示过去 6 个月 AAPL 的每日历史股价。"
• 财务健康: "获取 Microsoft 的季度资产负债表。"
• 绩效指标: "来自股票信息的 Tesla 的关键财务指标是什么？"
• 趋势分析: "比较 Amazon 和 Google 的季度利润表。"
• 现金流量分析: "显示 NVIDIA 的年度现金流量表。"

市场调查

• 新闻分析: "获取有关 Meta Platforms 的最新新闻文章。"
• 机构活动: "显示 Apple 股票的机构持股人。"
• 内幕交易: "Tesla 最近的内幕交易是什么？"
• 期权分析: "获取 SPY 的期权链，到期日为 2024-06-21，用于看涨期权。"
• 分析师覆盖: "过去 3 个月 Amazon 的分析师建议是什么？"

投资研究

• "使用 Microsoft 最新的季度财务报表，创建对其财务健康状况的全面分析。"
• "比较 Coca-Cola 和 PepsiCo 的股息历史和股票拆分。"
• "分析过去一年 Tesla 的机构所有权变化。"
• "生成一份关于 Apple 股票期权市场活动的报告，到期日为 30 天后。"
• "总结过去 6 个月科技行业最新的分析师升级和降级。"

要求

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

安装

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 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": "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"
           ]
         }
       }
     }
     

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

4. 重新启动 Claude for Desktop

许可证

MIT