AI导哈

金融数据协议服务器

Zentickr 是一个基于stdio的模型上下文协议（MCP）服务器，通过yahooquery库为AI助手提供23种雅虎财经工具访问，涵盖价格、基本面、报表、分析师研究、所有权、事件和符号发现等功能。

  • by chintan-diwakar
  • Python
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 ChintanDiwakar/zentickr-yahoo-query-mcp

使用说明

Zentickr——雅虎金融MCP服务器

Zentickr是一个基于stdio的模型上下文协议（MCP）服务器，它允许AI助手通过 yahooquery 库——涵盖价格、基本面、报表、分析师研究、所有权、事件和符号发现。

⚠️ 重要免责声明

本软件仅用于教育和信息目的。它不提供财务、投资、法律或税务建议。市场数据可能会延迟、不完整或不准确。您全权负责您的投资决策；作者对使用本软件造成的任何损失或损害不承担责任。

快速入门

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 桌面版

将此添加到 claude_desktop_config.json:

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

Claude 代码

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

光标

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

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

真实世界的用例

比较苹果和微软的基本面

提示： “比较苹果和微软的基本面。”

助理可以打电话 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]"

运行离线测试套件和linter：

pytest
ruff check .

看 贡献.md 查看完整的贡献指南。

数据源

数据来源于雅虎财经，通过非官方渠道 yahooquery 图书馆。它受雅虎条款的约束，不需要API密钥。

许可证

麻省理工学院——见 许可证.

支持

请打开一个 GitHub问题.

相关 MCP