AI导哈

金融数据服务

一个提供雅虎财经数据的模型上下文协议（MCP）服务器，支持AI助手通过标准化接口获取实时股票价格、财务报表、新闻、期权数据等。

  • by laxmimerit
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 laxmimerit/yahoo-finance-mcp-server

使用说明

雅虎金融MCP服务器

提供对雅虎财经数据访问的模型上下文协议（MCP）服务器。该服务器使AI助手能够通过标准化的界面获取实时股票价格、财务报表、新闻、期权数据等。

PIP：https://pypi.org/project/yahoo-finance-mcp-server/

特性

  • 历史股价：获取具有可自定义时段和间隔的历史价格数据
  • 股票信息：访问全面的股票数据，包括财务、指标和公司信息
  • 财务报表：检索损益表、资产负债表和现金流量表
  • 新闻：获取任何股票的最新新闻文章
  • 选项数据：获取期权链、到期日期和期权分析
  • 持有人信息：访问机构、共同基金和内部人士持有人数据
  • 分析师建议：获取分析师评级、升级和降级
  • 公司行为：跟踪股息和股票分割

安装

使用uvx（推荐）

使用此MCP服务器的最简单方法是 uvx，无需安装即可直接运行：

uvx yahoo-finance-mcp-server

使用紫外线

使用安装软件包 uv:

uv pip install yahoo-finance-mcp-server

使用pip

pip install yahoo-finance-mcp-server

来源

git clone https://github.com/laxmimerit/yahoo-finance-mcp-server.git
cd yahoo-finance-mcp-server
uv pip install -e .

配置

Claude桌面配置

将此添加到您的Claude Desktop配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

使用uvx（推荐）：

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "uvx",
      "args": ["yahoo-finance-mcp-server"]
    }
  }
}

使用紫外线：

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "uv",
      "args": ["run", "yahoo-finance-mcp-server"]
    }
  }
}

直接使用Python：

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "python",
      "args": ["-m", "yahoo_finance_mcp_server.server"]
    }
  }
}

其他MCP客户端

对于支持stdio传输的其他MCP客户端，您可以运行：

yahoo-finance-mcp-server

或者使用uvx：

uvx yahoo-finance-mcp-server

可用工具

1.获取历史库存价格

获取股票代码的历史股价。

参数：

  • ticker （str）：股票代码（例如“AAPL”）
  • period （STR，可选）：有效期：1天、5天、1个月、3个月、6个月、1年、2年、5年、10年、年初至今，最大默认值：“1个月”
  • interval （str，可选）：有效间隔：1m、2m、5m、15m、30m、60m、90m、1h、1d、5d、1wk、1mo、3mo。默认值：“1d”

例子：

Get historical prices for Apple stock over the last year

2.get_stock_info

获取全面的股票信息，包括价格、公司详细信息、财务指标等。

参数：

  • ticker （str）：股票代码（例如“TSLA”）

例子：

Get detailed information about Tesla stock

3.get_yahoo_finance_news

获取股票代码的最新新闻文章。

参数：

  • ticker （str）：股票代码（例如“GOOGL”）

例子：

Get recent news about Google

4.get_stock_actions

获取股息和股票分割历史记录。

参数：

  • ticker （str）：股票代码（例如“MSFT”）

例子：

Get dividend history for Microsoft

5.财务报表

获取财务报表（损益表、资产负债表或现金流量表）。

参数：

  • ticker （str）：股票代码（例如“AMZN”）
  • financial_type （str）：以下之一： income_stmt, quarterly_income_stmt, balance_sheet, quarterly_balance_sheet, cashflow, quarterly_cashflow

例子：

Get Amazon's quarterly income statement

6.获取文件夹信息

获取持有人和所有权信息。

参数：

  • ticker （str）：股票代码（例如“NVDA”）
  • holder_type （str）：以下之一： major_holders, institutional_holders, mutualfund_holders, insider_transactions, insider_purchases, insider_roster_holders

例子：

Get institutional holders of NVIDIA

7.获取期权到期日期

获取股票代码的可用选项到期日期。

参数：

  • ticker （str）：股票代码（例如“SPY”）

例子：

Get option expiration dates for SPY

8.获取选项链

获取看涨或看跌期权链数据。

参数：

  • ticker （str）：股票代码（例如“AAPL”）
  • expiration_date （str）：YYYY-MM-DD格式的到期日期
  • option_type （str）：要么“calls”要么“puts”

例子：

Get Apple call options expiring on 2024-12-20

9.获得表彰

获取分析师建议和升级/降级。

参数：

  • ticker （str）：股票代码（例如“META”）
  • recommendation_type （str）：“建议”或“升级_降级”
  • months_back （int，可选）：回顾的月份数。默认值：12

例子：

Get recent analyst upgrades for Meta

使用示例

一旦配置了Claude Desktop或其他MCP客户端，您可以提出以下问题：

  • “苹果股票的当前价格是多少？”
  • “给我看看特斯拉去年的季度收入”
  • “获取有关Microsoft的最新消息”
  • “可口可乐的股息是多少？”
  • “向我展示NVIDIA的机构持有者”
  • “获取亚马逊的资产负债表”
  • “SPY有哪些选项？”
  • “显示谷歌最近的分析师升级”

发展

设置开发环境

# Clone the repository
git clone https://github.com/laxmimerit/yahoo-finance-mcp-server.git
cd yahoo-finance-mcp-server

# Install with development dependencies
uv pip install -e ".[dev]"

运行测试

pytest

代码格式化

black src/
ruff check src/

技术细节

  • 协议：模型上下文协议（MCP）
  • 运输标准： stdio
  • 数据源：雅虎财经通过yfinance库
  • 响应格式：JSON

需求

  • Python 3.10或更高版本
  • 依赖关系：
    • fastmcp>=0.3.0
    • 融资>=0.2.40
    • 熊猫>=2.0.0

局限性

  • 数据由雅虎财经提供，并受其服务条款的约束
  • 实时数据可能会有延迟，具体取决于您的订阅级别
  • 某些数据可能并非适用于所有股票代码
  • 日内数据仅限于过去60天

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

免责声明

本软件仅供参考。不应将其视为财务建议。在做出投资决策之前，一定要做自己的研究。

支持

如果您遇到任何问题或有疑问：

  • 在GitHub上打开一个问题
  • 检查现有问题的解决方案
  • 请参阅MCP文件https://modelcontextprotocol.io

致谢

相关 MCP