Zentickr Yahoo Query Mcp Server

Zentickr — Yahoo Finance MCP 服务

Zentickr 是一个基于 stdio 的模型上下文协议（MCP）服务，可通过 yahooquery 库为 AI 助手提供 23 种 Yahoo Finance 工具，涵盖价格、基本面、报表、分析师研究、所有权、事件和代码发现。

⚠️ 重要免责声明

本软件仅用于教育和信息用途，不提供财务、投资、法律或税务建议。市场数据可能存在延迟、不完整或不准确的情况。您须对自己的投资决策承担全部责任；作者不对因使用本软件而产生的任何损失或损害承担责任。

快速开始

git clone https://github.com/chintan-diwakar/zentickr-yahoo-query-mcp.git
cd zentickr-yahoo-query-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e .

通过 stdio 运行服务：

zentickr

或者：

python -m zentickr

客户端设置

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "zentickr": {
      "command": "/absolute/path/to/zentickr-yahoo-query-mcp/.venv/bin/zentickr"
    }
  }
}

Claude Code

claude mcp add zentickr -- /absolute/path/to/zentickr-yahoo-query-mcp/.venv/bin/zentickr

Cursor

创建或更新 .cursor/mcp.json：

{
  "mcpServers": {
    "zentickr": {
      "command": "/absolute/path/to/zentickr-yahoo-query-mcp/.venv/bin/zentickr"
    }
  }
}

实际应用场景

比较 Apple 和 Microsoft 的基本面

提示词：“比较 Apple 和 Microsoft 的基本面。”

助手可以调用 get_financial_data(symbols="AAPL,MSFT") 和 get_valuation_measures(symbols="AAPL,MSFT")。

捕获的输出摘录：

Financial Data:
{
  "AAPL": {
    "currentPrice": 333.26,
    "targetHighPrice": 400.0,
    "targetLowPrice": 215.0,
    "targetMeanPrice": 315.78604,
    "recommendationKey": "buy",
    "numberOfAnalystOpinions": 43,
    "totalCash": 68507000832,
    "totalDebt": 84710998016,
    "totalRevenue": 451442016256,
    "earningsGrowth": 0.218,
    "revenueGrowth": 0.166
  }
}

Valuation Measures:
[
  {
    "symbol": "AAPL",
    "asOfDate": "2026-05-28 00:00:00",
    "periodType": "TTM",
    "ForwardPeRatio": 35.3357,
    "MarketCap": 4589945623560.0,
    "PbRatio": 43.101723,
    "PeRatio": 37.83414,
    "PegRatio": 2.7194
  }
]

帮我准备 AAPL 财报

提示词：“帮我准备 AAPL 财报。”

助手可以调用 get_calendar_events(symbols="AAPL") 和 get_earnings_trend(symbols="AAPL")。

捕获的输出摘录：

Calendar Events:
{
  "AAPL": {
    "earnings": {
      "earningsDate": [
        "2026-07-31 01:30:S"
      ],
      "earningsAverage": 1.89396,
      "earningsLow": 1.83,
      "earningsHigh": 1.99,
      "revenueAverage": 108890141050
    }
  }
}

Earnings Trend:
{
  "AAPL": {
    "trend": [
      {
        "period": "0q",
        "endDate": "2026-06-30",
        "growth": 0.20629999,
        "earningsEstimate": {
          "avg": 1.89396,
          "numberOfAnalysts": 31,
          "yearAgoEps": 1.57
        }
      }
    ]
  }
}

查找 NVIDIA 的股票代码和当前价格

提示词：“查找 NVIDIA 的股票代码和当前价格。”

助手可以先调用 search_symbols(query="nvidia")，然后调用 get_price_data(symbols="NVDA")。

捕获的输出摘录：

Search Results for 'nvidia':
[
  {
    "symbol": "NVDA",
    "name": "NVIDIA Corporation",
    "type": "EQUITY",
    "exchange": "NMS"
  }
]

Price Data:
{
  "NVDA": {
    "preMarketPrice": 202.155,
    "regularMarketPrice": 207.4,
    "regularMarketDayHigh": 211.08,
    "regularMarketDayLow": 205.85,
    "regularMarketVolume": 116253420,
    "regularMarketPreviousClose": 212.5,
    "exchangeName": "NasdaqGS",
    "marketState": "PRE",
    "symbol": "NVDA"
  }
}

工具目录

市场数据

工具	参数	返回内容
get_price_data	symbols: str	当前价格和交易数据
get_summary_detail	symbols: str	日内区间、成交量、股息和 52 周区间
get_historical_prices	symbols: str、period: str | None = None、start_date: str | None = None、end_date: str | None = None、interval: str = "1d"	历史 OHLCV 价格数据
get_calendar_events	symbols: str	即将公布的财报日期和股息事件

财务报表

工具	参数	返回内容
get_financial_data	symbols: str	关键财务数据，包括目标价、利润率、现金、债务和增长
get_balance_sheet	symbols: str、frequency: str = "annual"	资产负债表数据
get_cash_flow	symbols: str、frequency: str = "annual"	现金流量表
get_income_statement	symbols: str、frequency: str = "annual"	利润表
get_valuation_measures	symbols: str	市值、市盈率、企业价值和市净率指标
get_earnings	symbols: str	财报数据
get_earnings_trend	symbols: str	盈利趋势预估

分析与研究

工具	参数	返回内容
get_recommendations	symbols: str	分析师评级
get_recommendation_trend	symbols: str	强烈买入、买入、持有、卖出和强烈卖出的数量
get_technical_insights	symbols: str	技术分析见解
get_esg_scores	symbols: str	环境、社会和治理评分
get_company_profile	symbols: str	公司所属板块、行业、简介和地址

所有权与治理

工具	参数	返回值
get_major_holders	symbols: str	主要持有人构成
get_institution_ownership	symbols: str	机构持股情况
get_insider_holders	symbols: str	内部人士持股情况
get_insider_transactions	symbols: str	内部人士交易
get_fund_ownership	symbols: str	共同基金和 ETF 持股情况
get_company_officers	symbols: str	高管、职务和薪酬

搜索发现

工具	参数	返回值
search_symbols	query: str	按公司名称或部分股票代码匹配的股票代码

symbols 是逗号分隔的字符串，例如 "AAPL,GOOGL,MSFT"。报表频率可设为 "annual" 或 "quarterly"。

开发

安装开发依赖：

pip install -e ".[dev]"

运行离线测试套件和代码检查工具：

pytest
ruff check .

完整的贡献指南请参阅 CONTRIBUTING.md。

数据来源

数据通过非官方的 yahooquery 库从 Yahoo Finance 获取。数据受 Yahoo 的条款约束，且无需 API 密钥。

许可证

MIT——请参阅 LICENSE。

支持

请提交 GitHub Issue。