⚙

金融数据服务

提供来自Yahoo Finance的全面金融数据服务，包括股票信息、财务报表、期权数据等。

作者 By Alex2Yang97

本地部署金融数据股票分析

GitHub

雅虎金融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，包括：
主控程序
y融资
熊猫
皮丹提克
以及用于数据处理的其他软件包

设置

推荐：跑步 `uvx`

直接从存储库运行服务器，而无需创建本地虚拟环境：

BASH``` 1uvx —from git+https://github.com/Alex2Yang97/yahoo-finance-mcp yahoo-finance-mcp


### 本地开发


1. 克隆此存储库：


BASH```
1
2git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
cd yahoo-finance-mcp

创建和激活虚拟环境并安装依赖项：

BASH``` 1 2 3uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -e .



## 用法


### 快速开始


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


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

对于此签出中的本地更改，请使用：

BASH``` 1uvx —from . yahoo-finance-mcp


### 发展模式


如果您在本地克隆中工作，并希望直接运行源代码树：


BASH```
1uv run server.py

与Claude for Desktop集成

要将此服务器与Claude for Desktop集成，请执行以下操作：

将Claude for Desktop安装到本地计算机。
将VS Code安装到本地计算机。然后运行以下命令打开 claude_desktop_config.json 文件：

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

编辑Claude for Desktop配置文件，位于：

macOS：

JSON``` 1 2 3 4 5 6 7 8 9 10 11 12{ “mcpServers”: { “yfinance”: { “command”: “uvx”, “args”: [ “—from”, “git+https://github.com/Alex2Yang97/yahoo-finance-mcp”, “yahoo-finance-mcp” ] } } }

- 窗户：


JSON```
1
2
3
4
5
6
7
8
9
10
11
12{
  "mcpServers": {
    "yfinance": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Alex2Yang97/yahoo-finance-mcp",
        "yahoo-finance-mcp"
      ]
    }
  }
}

备注：您可能需要在命令字段中输入uv可执行文件的完整路径。你可以通过跑步来获得这个 which uv 在MacOS/Linux或 where uv 在Windows上。

重新启动桌面版的Claude

许可证

麻省理工学院