Skip to main content
Glama
Yahoo Finance MCP Server

Yahoo Finance MCP Server

by narumiruna

Yahoo Finance MCP 服务器

PyPI version Python CI License: MIT

一个 模型上下文协议 (MCP) 服务器,为 AI 助手提供通过 yfinance 访问 Yahoo Finance 数据的能力。您可以直接在 AI 对话中查询股票信息、财经新闻、行业排名并生成专业的金融图表。

功能

  • 股票数据 — 公司信息、财务状况、估值指标、股息和交易数据

  • 财务报表 — 包含历史数据(息税前利润 EBIT、投入资本等)的损益表和资产负债表

  • 财经新闻 — 任何股票代码的最新新闻文章和新闻稿

  • 搜索 — 在 Yahoo Finance 中查找股票、ETF 和新闻

  • 行业排名 — 各行业的顶级 ETF、共同基金、公司、增长领军企业和表现最佳者

  • 价格历史 — 以 Markdown 表格或专业图表形式呈现的历史 OHLCV 数据

  • 图表生成 — 以 WebP 图像格式返回 K 线图、VWAP 和成交量分布图

Related MCP server: DuckDuckGo MCP Server

工具

yfinance_get_ticker_info

获取全面的股票数据,包括公司信息、财务状况、交易指标和治理数据。

参数

类型

必需

描述

symbol

string

是

股票代码 (例如 AAPL, GOOGL, MSFT)

返回: 包含公司详情、价格数据、估值指标、交易信息、股息、财务状况和绩效指标的 JSON 对象。

yfinance_get_ticker_news

获取特定股票的最新新闻文章和新闻稿。

参数

类型

必需

描述

symbol

string

是

股票代码

返回: 包含标题、摘要、发布日期、提供商、URL 和缩略图的新闻项 JSON 数组。

在 Yahoo Finance 中搜索股票、ETF 和新闻文章。

参数

类型

必需

描述

query

string

是

搜索查询 — 公司名称、股票代码或关键词

search_type

string

是

"all" (报价+新闻), "quotes" (仅股票/ETF), 或 "news" (仅文章)

返回: 根据 search_type 返回匹配的报价和/或新闻结果。

yfinance_get_top

获取市场行业内排名靠前的金融实体。

参数

类型

必需

描述

sector

string

是

市场行业 (见下文 支持的行业)

top_type

string

是

"top_etfs", "top_mutual_funds", "top_companies", "top_growth_companies", 或 "top_performing_companies"

top_n

number

否

返回的结果数量 (默认: 10, 最大: 100)

返回: 包含相关指标的顶级实体 JSON 数组。

支持的行业

Basic Materials (基础材料), Communication Services (通信服务), Consumer Cyclical (消费周期), Consumer Defensive (消费防御), Energy (能源), Financial Services (金融服务), Healthcare (医疗保健), Industrials (工业), Real Estate (房地产), Technology (科技), Utilities (公用事业)

yfinance_get_price_history

获取历史价格数据并可选择生成技术分析图表。

参数

类型

必需

描述

symbol

string

是

股票代码

period

string

否

时间范围 — 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max (默认: 1mo)

interval

string

否

数据粒度 — 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo (默认: 1d)

chart_type

string

否

要生成的图表 (省略则返回表格数据)

图表类型:

值

描述

"price_volume"

带成交量柱状图的 K 线图

"vwap"

带成交量加权平均价格 (VWAP) 叠加的价格图表

"volume_profile"

带价格水平成交量分布的 K 线图

返回:

  • 无 chart_type 时:包含日期、开盘价、最高价、最低价、收盘价、成交量、股息和股票拆分列的 Markdown 表格。

  • 有 chart_type 时:用于高效 Token 使用的 Base64 编码 WebP 图像。

yfinance_get_financials

获取包含历史数据的财务报表(损益表、资产负债表和现金流量表)。

参数

类型

必需

描述

symbol

string

是

股票代码

frequency

string

否

"annual" (年度), "quarterly" (季度), 或 "ttm" (过去十二个月)。默认: "annual"

返回: 包含每个报告期损益表、资产负债表和现金流量数据的 JSON 对象。

  • 损益表字段: EBIT, Net Income (净利润), Tax Provision (税项准备), Pretax Income (税前利润), Interest Expense (利息支出), Total Revenue (总收入), Operating Income (营业利润), EBITDA, Normalized Income (归一化利润)

  • 资产负债表字段: Stockholders Equity (股东权益), Total Debt (总债务), Cash And Cash Equivalents (现金及现金等价物), Invested Capital (投入资本), Net Debt (净债务), Total Assets (总资产), Total Liabilities Net Minority Interest (总负债扣除少数股东权益), Net Tangible Assets (净有形资产), Tangible Book Value (有形账面价值)

  • 现金流量表字段: Operating Cash Flow (经营现金流), Free Cash Flow (自由现金流), Capital Expenditure (资本支出), Net Income From Continuing Operations (持续经营净利润), Depreciation And Amortization (折旧与摊销), Change In Working Capital (营运资金变动), Cash Dividends Paid (已付现金股息)

使用方法

通过 uv (推荐)

  1. 安装 uv

  2. 将以下内容添加到您的 MCP 客户端配置中:

{
  "mcpServers": {
    "yfmcp": {
      "command": "uvx",
      "args": ["yfmcp@latest"]
    }
  }
}

通过 Docker

{
  "mcpServers": {
    "yfmcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "narumi/yfinance-mcp"]
    }
  }
}

从源码安装

  1. 克隆仓库并安装依赖:

git clone https://github.com/narumiruna/yfinance-mcp.git
cd yfinance-mcp
uv sync
  1. 将以下内容添加到您的 MCP 客户端配置中:

{
  "mcpServers": {
    "yfmcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/yfinance-mcp",
        "yfmcp"
      ]
    }
  }
}

将 /path/to/yfinance-mcp 替换为您克隆仓库的实际路径。

开发

前置要求

  • Python ≥ 3.12

  • uv 包管理器

设置

uv sync --extra dev

Lint 与格式化

uv run ruff check .
uv run ruff format .

类型检查

uv run ty check src tests

测试

uv run pytest -v -s --cov=src tests

演示聊天机器人

请查看专用仓库中的演示聊天机器人:yfinance-mcp-demo

贡献者

由 contrib.rocks 制作。

许可证

本项目采用 MIT 许可证 开源。

Available Tools

15 tools
yfinance_get_analyst_estimatesB
Read-onlyIdempotent

Fetch consensus estimates, EPS/revenue trends, revisions, recommendations, and earnings history.

Inputs: symbol (required), max_rows, sections. Returns: result

yfinance_get_analyst_price_targetsA
Read-onlyIdempotent

Fetch the current price and analyst consensus price targets for a stock.

Returns a JSON object with the fields supplied by Yahoo Finance:
- current: Current market price
- low: Lowest analyst price target
- high: Highest analyst price target
- mean: Mean analyst price target
- median: Median analyst price target

Analyst coverage and available fields vary by symbol.

Inputs: symbol (required). Returns: result

yfinance_get_financialsA
Read-onlyIdempotent

Fetch financial statements (income statement, balance sheet, and cash flow) with historical data.

Returns JSON with income statement, balance sheet, and cash flow data across reporting periods.

Use the data to analyze trends, calculate ratios, or compare periods.

Inputs: symbol (required), frequency. Returns: result

yfinance_get_fund_dataA
Read-onlyIdempotent

Fetch ETF or mutual-fund composition, holdings, exposures, ratings, and operating details.

Inputs: symbol (required), max_rows, sections. Returns: result

yfinance_get_holdersA
Read-onlyIdempotent

Fetch major holders, institutional holders, mutual fund holders, and insider data.

Returns JSON with:
- major_holders: Aggregated breakdown including insider % held, institutional % held,
  institutional % float held, and institution count.
- institutional_holders: List of institutional investors with shares held, date reported,
  value, and % change.
- mutualfund_holders: List of mutual fund holders with same fields.
- insider_transactions: Recent insider transactions including shares, value, transaction
  type, and date.
- insider_purchases: Summary of insider buy/sell activity over the last 6 months.
- insider_roster: List of known insiders by name and position.

Use this to analyze ownership concentration, insider activity, and institutional interest.

Inputs: symbol (required), max_rows. Returns: result

yfinance_get_option_chainA
Read-onlyIdempotent

Fetch option chain data (calls and puts) for a stock with available strike prices.

Returns JSON with calls and/or puts data for each expiration date.

JSON fields include:
- contractSymbol: Option contract identifier
- strike: Strike price
- lastPrice: Last traded price
- bid/ask: Bid and ask prices
- volume: Trading volume
- openInterest: Open interest
- impliedVolatility: Implied volatility (IV)
- inTheMoney: Whether option is ITM
- contractSize: Contract size (REGULAR)
- currency: Currency (USD)

Use this to analyze options pricing, IV surfaces, and strike levels.

Inputs: symbol (required), option_type, expiration_date. Returns: result

yfinance_get_option_datesA
Read-onlyIdempotent

Fetch available option expiration dates for a stock.

Returns JSON array of expiration dates in YYYY-MM-DD format.

Use these dates with the 'yfinance_get_option_chain' tool to fetch
the options chain for a specific date.

Inputs: symbol (required). Returns: result

yfinance_get_price_historyA
Read-onlyIdempotent

Fetch historical price data and optionally generate technical analysis charts.

When chart_type is None, returns Markdown table with columns:
- Date: Trading date (index)
- Open: Opening price
- High: Highest price
- Low: Lowest price
- Close: Closing price
- Volume: Trading volume
- Dividends: Dividend payments (if any)
- Stock Splits: Split events (if any)

When chart_type is specified, returns a chart image:
- 'price_volume': Candlestick chart with volume bars
- 'vwap': Price with Volume Weighted Average Price overlay
- 'volume_profile': Volume distribution by price level

Set prepost=True to include pre-market and post-market data when available.

Note: Not all period/interval combinations are valid. Minute intervals (1m, 5m, etc.)
only work with short periods (1d, 5d).

Inputs: symbol (required), period, prepost, interval, +1 more. Returns: result

yfinance_get_ticker_infoA
Read-onlyIdempotent

Retrieve comprehensive stock data including company information, financials, trading metrics and governance.

Returns JSON object with fields including:
- Company: symbol, longName, sector, industry, longBusinessSummary, website, city, country
- Price: currentPrice, previousClose, open, dayHigh, dayLow, fiftyTwoWeekHigh, fiftyTwoWeekLow
- Valuation: marketCap, enterpriseValue, trailingPE, forwardPE, priceToBook, pegRatio
- Trading: volume, averageVolume, averageVolume10days, bid, ask, bidSize, askSize
- Dividends: dividendRate, dividendYield, exDividendDate, payoutRatio
- Financials: totalRevenue, revenueGrowth, earningsGrowth, profitMargins, operatingMargins
- Performance: beta, fiftyDayAverage, twoHundredDayAverage, trailingEps, forwardEps

Note: Available fields vary by security type. Timestamps are converted to readable dates.

Inputs: symbol (required). Returns: result

yfinance_get_ticker_newsA
Read-onlyIdempotent

Fetch recent news articles and press releases for a specific stock.

Returns JSON array where each news item has:
- id: Unique article identifier
- content: Object containing:
    - title: Article headline
    - summary: Brief article summary
    - pubDate: Publication date (ISO 8601 format)
    - provider: Object with displayName (e.g., "Yahoo Finance") and url
    - canonicalUrl: Object with article url, site, region, lang
    - thumbnail: Object with image URLs and resolutions
    - contentType: Type of content (e.g., "STORY", "VIDEO")

Use this to track company announcements, market sentiment, and breaking news.

Inputs: symbol (required). Returns: result

yfinance_get_topA
Read-onlyIdempotent

Get top-ranked financial entities within a sector.

This unified tool provides access to various rankings:
- ETFs and mutual funds focused on the sector
- Largest companies by market capitalization
- Fastest-growing companies by revenue/earnings
- Best-performing stocks by price appreciation

Returns JSON data with relevant metrics for each entity type.

Inputs: sector (required), top_type (required), top_n. Returns: result

yfinance_get_upgrades_downgradesB
Read-onlyIdempotent

Fetch analyst upgrades, downgrades, initiations, and price target changes.

Returns analyst actions newest first. Fields supplied by Yahoo Finance can include:
- GradeDate: Date and time of the analyst action
- Firm: Analyst firm name
- ToGrade and FromGrade: New and previous ratings
- Action: Rating action, such as upgrade, downgrade, initiation, or reiteration
- priceTargetAction: Price target action, such as Raises, Lowers, or Maintains
- currentPriceTarget and priorPriceTarget: New and previous price targets

Available fields vary by symbol and analyst action.

Inputs: symbol (required), max_rows. Returns: result

yfinance_screenA
Read-onlyIdempotent

Run a Yahoo Finance screener query.

Supports predefined Yahoo screener keys and custom equity, mutual-fund, or ETF query trees.

Inputs: query (required), size, count, offset, +5 more. Returns: result

yfinance_screen_gappersA
Read-onlyIdempotent

Run a custom equity screener tuned for opening-session stock gappers.

Inputs: size, offset, region, sort_asc, +4 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool targets a distinct data domain: ticker info, analyst data, news, search, screening, price history, financials, options, and holders. Even the closely related analyst and screener tools are clearly separated by their specific outputs and descriptions.

    Naming Consistency4/5

    The tools consistently use the yfinance_ prefix and snake_case, with most following a yfinance_get_* pattern. A few exceptions like yfinance_search, yfinance_screen, and yfinance_screen_gappers break the pattern slightly but remain predictable and readable.

    Tool Count5/5

    At 15 tools, the set is at the upper edge of well-scoped but still appropriate for Yahoo Finance's broad data coverage. Each tool covers a meaningful financial data category without obvious redundancy.

    Completeness5/5

    The surface comprehensively covers the main Yahoo Finance data categories: quotes, financials, price history, options, holders, news, analyst activity, screening, rankings, and fund data. For a read-only financial data server, there are no significant dead ends or missing core operations.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server built with FastMCP framework that provides example tools including message echoing and server information retrieval. Supports both stdio and HTTP transports with Docker deployment capabilities.
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server built with FastMCP framework that provides example tools for echoing messages and retrieving server information. Supports both stdio and HTTP transports with Docker deployment capabilities.
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server with example tools including message echo functionality and server information retrieval. Built with FastMCP framework and supports both stdio and HTTP transports.
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A basic MCP server built with FastMCP framework that provides example tools including message echoing and server information retrieval. Supports both stdio and HTTP transports for integration with various MCP clients.
      -