金融数据服务

Yahoo Finance MCP Server是一个提供全面金融数据的服务,包括股票历史价格、公司信息、财务报表、期权数据及市场新闻。

  • by hwangwoohyun-nav
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 hwangwoohyun-nav/yahoo-finance-mcp

使用说明

雅虎金融MCP服务器

English | 中文

这是一个模型上下文协议(MCP)服务器,提供来自雅虎财经的全面财务数据。它允许您检索有关股票的详细信息,包括历史价格、公司信息、财务报表、期权数据和市场新闻。

演示

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的历史股价,每天都有。”
  • 财务健康状况:“获取微软的季度资产负债表。”
  • 性能指标:“从股票信息来看,特斯拉的关键财务指标是什么?”
  • 趋势分析:“比较亚马逊和谷歌的季度损益表。”
  • 现金流量分析:“给我看看NVIDIA的年度现金流量表。”

市场调研

  • 新闻分析:“获取有关元平台的最新新闻文章。”
  • 机构活动:“给我看看苹果股票的机构持有者。”
  • 内幕交易:“特斯拉最近的内幕交易是什么?”
  • 期权分析:“获取到期日为2024-06-21的SPY期权链。”
  • 分析师覆盖范围:“过去3个月,分析师对亚马逊有什么建议?”

投资研究

  • “使用微软最新的季度财务报表,对微软的财务状况进行全面分析。”
  • “比较可口可乐和百事可乐的股息历史和股票分割。”
  • “分析特斯拉过去一年的机构所有权变化。”
  • “生成一份关于30天后到期的苹果股票期权市场活动的报告。”
  • “总结过去6个月科技行业分析师的最新升级和降级。”

需求

  • Python 3.11或更高版本
  • 依赖关系如所列 pyproject.toml,包括:
    • 主控程序
    • 金融
    • 熊猫
    • 媒染剂
    • 以及用于数据处理的其他软件包

设置

  1. 克隆此存储库:

    git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
    cd yahoo-finance-mcp
    
  2. 创建和激活虚拟环境并安装依赖项:

    uv venv
    source .venv/bin/activate  # On 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
    • 窗户: 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"
            ]
          }
        }
      }
      
    • 窗户:

      {
        "mcpServers": {
          "yfinance": {
            "command": "uv",
            "args": [
              "--directory",
              "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\yahoo-finance-mcp",
              "run",
              "server.py"
            ]
          }
        }
      }
      
    • 备注:您可能需要在命令字段中输入uv可执行文件的完整路径。你可以通过跑步来获得这个 which uv 在MacOS/Linux或 where uv 在Windows上。

  4. 重新启动桌面版的Claude

许可证

麻省理工学院