ApexVol Options Analytics

ApexVol MCP 服务

一个模型上下文协议（MCP）服务，让 AI 助手能够实时访问 ApexVol 的期权分析平台：期权链、IV 排名、波动率风险溢价、希腊值、伽马敞口（GEX）、预期波动幅度、策略构建和市场筛选。44 个工具，一个连接器。

支持 Claude Code、Claude Desktop、claude.ai（远程连接器，无需安装）以及任何兼容 MCP 的客户端。

• 逐步设置指南： https://apexvol.com/learn/claude-options-data-mcp
• REST API 文档： https://apexvol.com/docs/api
• 适用于大模型上下文窗口的单文件 API 参考： https://apexvol.com/docs/api/apexvol-api.md

快速开始

选项 A — 远程连接器（无需安装）

ApexVol 已列入 Claude 的连接器目录：打开 **https://claude.ai/directory/apexvol**（或在 claude.ai 或 Claude Desktop 中选择 Customize → Connectors → Discover 并搜索 ApexVol），然后选择 Connect to Claude。

根据提示使用你的 ApexVol 账户登录（OAuth）即可。无需 Python，也无需配置文件。

也可以手动添加（或在其他 MCP 客户端中添加），将以下 URL 用作自定义连接器：

https://apexvol.com/mcp-server

Claude Code 也可以使用远程服务：

claude mcp add --transport http apexvol https://apexvol.com/mcp-server

然后根据提示进行身份验证（/mcp 命令会显示登录状态）。

选项 B — 本地安装（stdio）

pipx install apexvol-mcp
claude mcp add apexvol -e APEXVOL_API_TOKEN=avmcp_YOUR_TOKEN_HERE -- apexvol-mcp

访问需要任意付费 ApexVol 套餐（每月 55 美元起）。 每个工具返回的数据级别与网页套餐包含的级别相同；Pro 可解锁完整工具集。令牌可在 apexvol.com/account → API Access 自助获取。

会话示例

真实输出，2026-08-15：

你： SPY 的 IV 排名是多少？

Claude 调用 get_iv_rank("SPY")：

指标	值
当前 IV	12.3%
IV 排名	7.8
IV 百分位	8.3%
52 周低点	11.2%
52 周高点	25.0%

评估：低——考虑买入而不是卖出权利金。

后续问题，例如“那么这里日历价差是不是比铁鹰价差更合适？”，也能得到回答，因为 Claude 可以在同一段对话中获取期限结构、构建两种策略并比较希腊值。

架构

Remote (no install)
┌─────────────────────────┐            ┌──────────────────────────────┐
│ claude.ai / Desktop /   │── OAuth ──▶│ https://apexvol.com/mcp-server│
│ Claude Code (HTTP)      │            │ (streamable HTTP)             │
└─────────────────────────┘            └──────────────────────────────┘

Local (stdio)
┌─────────────────────┐               ┌─────────────────────┐
│ Claude Code/Desktop │               │ apexvol.com         │
│         │           │               │                     │
│         ▼           │               │                     │
│   ApexVol MCP       │──── HTTPS ───▶│  /api/mcp/data/...  │
│   (runs locally)    │               │                     │
└─────────────────────┘               └─────────────────────┘

本地服务在你的计算机上运行，并调用 ApexVol 平台 API。远程服务由 ApexVol 托管，提供相同的工具集，使用 OAuth 而非令牌进行身份验证。

功能

• 43 个分析工具 — Claude 可以访问每个 /api/mcp/data 端点
• 内置参考 — help 工具可根据内置的 API 文档副本回答“哪个工具能提供 X”；客户端的提示词选择器中还会显示 41 个提示词：33 个入门提示词，每个数据系列 3 个，另有 8 个完整任务方案
• 自然语言界面 - 可以询问“SPY 的 IV 排名是多少？”之类的问题
• 远程或本地 - 可使用托管的 OAuth 连接器，或通过 pipx 安装的 stdio 服务
• 令牌身份验证 - 安全验证 API 令牌（本地模式）
• 内置运行状况检查 - apexvol-mcp --check 可验证安装和令牌

可用工具

期权链（6 个工具）

• get_options_chain - 获取任意股票代码的完整期权链
• get_expirations - 获取可用到期日
• get_options_by_delta - 查找指定 Delta 的期权
• get_stock_price - 获取当前价格和公司信息
• calculate_expected_move - 根据跨式定价计算预期波动幅度；tickers="SPY,AAPL,NVDA" 可在一次调用中为最多 25 个标的定价（0.1.4）
• get_historical_chain - 获取任意过去交易日的期权链快照

波动率分析（7 个工具）

• get_iv_rank - IV 排名和百分位；tickers="SPY,QQQ,IWM" 可在一次调用中为最多 25 个标的排名（0.1.4）
• get_volatility_cone - IV 与历史实现波动率对比
• get_volatility_risk_premium - VRP（IV 减去 RV）
• get_term_structure - 各到期日的 IV
• find_iv_opportunities - 均值回归机会
• get_vix_snapshot - VIX 水平和期限结构状态
• get_monies_surface - 平滑波动率曲面：隐含波动率、预测波动率，或模型与市场对比

Greeks 与 GEX（5 个工具）

• get_gex - 按行权价计算 Gamma 敞口；tickers= 可批量处理最多 25 个标的，strikes_around 和 detail 可控制载荷大小（0.1.4）
• get_charm_exposure - Delta 衰减敞口
• get_third_order_greeks - Speed、zomma、color、vomma、ultima
• get_greeks_heatmap - 各行权价和到期日的 Greeks
• get_cross_index_gex - 比较各指数的 GEX

期权流（3 个工具）

• get_options_flow - 交易流和异常活动（市场休市时显示日终数据；如果成交量数据源暂无数据，会解释原因，而不会返回零值）；limit 和 detail 可控制行列表大小（0.1.4）
• get_smart_money_flow - 机构交易流模式 ⚠️ 与上文有相同限制
• scan_volatility_arb - 跨指数波动率套利

策略构建（5 个工具）

• build_strategy - 构建期权策略（铁鹰式、价差等）
• analyze_strategy - 全面的盈亏和 Greeks 分析
• optimize_strategy - 查找最优行权价
• simulate_option_chain - Black-Scholes 假设情景重新定价（价格/DTE/IV 变化）
• calculate_probability_of_profit - 计算任意腿组合的 PoP

风险管理（4 个工具）

• calculate_portfolio_greeks - 汇总投资组合 Greeks
• run_scenario_analysis - 假设情景分析
• generate_stress_tests - 压力测试结果
• get_hedge_recommendations - Delta 对冲建议（股票 + 期权腿）

持仓以 JSON 数组传入（ticker、position_type、quantity、strike、 expiration、Greeks）——请先从 get_options_chain 获取期权 Greeks。仅含股票的投资组合也可使用纯文本（“AAPL 100 shares”）。

事件与筛选（5 个工具）

• get_earnings_calendar - 即将发布的财报
• analyze_earnings_history - 历史财报引发行情变动
• screen_market - 市场筛选（高 IV、异常成交量等）
• get_market_overview - 全市场波动率概览
• get_economic_calendar - 宏观事件（CPI、FOMC、就业数据等）

标的分析（8 个工具）

• get_ticker_analytics - 一个工具，八种视图：skew、dividends、 borrow_rate、correlation、hv_regimes、price_context、 relative_value、greeks_exposure
• get_earnings_move_analysis - 七种视图：mispricing、historical_moves、 expected_vs_actual、verdict、seasonality、post_drift、iv_crush
• get_max_pain - 最大痛点行权价和亏损概况
• get_volume_profile - 按行权价统计成交量/OI，并根据 OI 推算支撑位和阻力位
• get_zero_dte - 0DTE gamma、翻转水平、最大痛点、theta 衰减（SPY/QQQ/SPX...）；strikes_around 和 detail 可控制期权链大小（0.1.4）
• get_orats_cores - 原始供应商核心数据行（340 多个字段），支持字段选择
• search_tickers - 将名称解析为代码 / 检查覆盖范围
• scan_relative_value - 全市场 IV/SPY 均值回归和配对扫描

帮助与发现（1 个工具）

• help - 服务内的 API 参考。help() 会列出各类别及提问方式；help("get_iv_rank")、help("gex") 或 help("/iv-rank/{ticker}") 会返回工具、类别或端点记录 （问题、参数、单位、基准、字段、方案、提示词、文档 URL）；输入其他文字则会执行搜索。数据随包提供，不产生请求费用，设置令牌前即可使用。

提示词示例

该服务还注册了 41 个提示词，每个数据系列有 3 个，每种策略各有 1 个；它们会显示在 Claude Desktop、Cursor 和 VS Code 的提示词选择器中。每个提示词都将股票代码作为参数，并设有真实的默认值，列出可回答该问题的工具，并链接到相应的数据系列页面。措辞与提示词库保持一致。

安装（本地模式，详解）

前提条件

• Python 3.10+
• 任意付费 ApexVol 计划和一个 API 令牌（见下文“获取令牌”）

安装软件包

我们推荐使用 pipx，这样 apexvol-mcp 命令会彼此隔离，并始终位于你的 PATH 中：

pipx install apexvol-mcp

也可以直接使用 pip install apexvol-mcp。

或者从源代码安装：

git clone https://github.com/ryansilk/apexvol-mcp.git
cd apexvol-mcp
pip install -e .

验证安装

在修改任何 Claude 配置之前，请确认命令可正常运行，且令牌能够通过身份验证：

APEXVOL_API_TOKEN=avmcp_YOUR_TOKEN_HERE apexvol-mcp --check

--check 会显示客户端版本、身份验证结果，以及剩余的速率限制／月度额度。如果显示 OK，就只需将其接入 Claude。

配置

Claude Code（CLI）

运行一条命令：

claude mcp add apexvol -e APEXVOL_API_TOKEN=avmcp_YOUR_TOKEN_HERE -- apexvol-mcp

也可以手动添加到项目的 .mcp.json 或全局 ~/.claude.json 中：

{
  "mcpServers": {
    "apexvol": {
      "command": "apexvol-mcp",
      "env": {
        "APEXVOL_API_TOKEN": "avmcp_YOUR_TOKEN_HERE"
      }
    }
  }
}

Claude 桌面应用

macOS：编辑 ~/Library/Application Support/Claude/claude_desktop_config.json

Windows：编辑 %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "apexvol": {
      "command": "apexvol-mcp",
      "env": {
        "APEXVOL_API_TOKEN": "avmcp_YOUR_TOKEN_HERE"
      }
    }
  }
}

（Claude Desktop 也支持通过 Claude 连接器目录使用远程连接器——参见快速入门选项 A。）

环境变量

变量	必需	说明
APEXVOL_API_TOKEN	是	你的 ApexVol API 令牌
APEXVOL_API_URL	否	API URL（默认值：https://apexvol.com）

速率限制

每个账户每分钟 60 次请求、每小时 1,000 次、每月 10,000 次——本地模式和远程模式共用额度。apexvol-mcp --check 会显示剩余额度。

使用方法

配置完成后，重启 Claude Code 或 Claude Desktop 以加载 MCP 服务。

示例查询

波动率分析：

• “AAPL 的 IV 排名是多少？”
• “显示 SPY 的波动率锥”
• “TSLA 是否存在波动率风险溢价？”

期权链：

• “获取下周到期的 QQQ 期权链”
• “找出 NVDA 的 30 delta 看跌期权”
• “AMZN 财报的预期波动幅度是多少？”

希腊值与 GEX：

• “SPY 的 Gamma 敞口是多少？”
• “显示 QQQ 的 GEX 翻转点”
• “比较主要指数的 GEX”

流向分析：

• “今天 AAPL 的期权流向如何？”
• “META 是否有异常期权活动？”
• “扫描波动率套利机会”

策略构建：

• “在 SPY 上构建铁鹰策略”
• “分析 AAPL 的 150/155 看涨期权价差”
• “卖出 NVDA 的 200 看跌期权时，希腊值是多少？”

风险管理：

• “计算持有 100 股 AAPL 和 1 张 AAPL 200 看涨期权的投资组合希腊值”
• “对我的持仓进行压力测试”
• “我该如何对冲 Delta 敞口？”

市场概览：

• “今天的市场概览如何？”
• “显示 IV 排名较高的股票”
• “本周有哪些即将发布的财报？”

Agent 技能

仓库附带一个 Agent 技能，指导 AI 助手如何组合这些工具，完成全面分析——包括波动率高估／低估评估、财报策略、卖出期权费筛选、GEX 状态解读和策略压力测试，并提供解读阈值与错误处理方法。

如需在 Claude Code 中使用，请将该技能复制到你的技能目录：

mkdir -p ~/.claude/skills/options-analysis
curl -o ~/.claude/skills/options-analysis/SKILL.md \
  https://raw.githubusercontent.com/ryansilk/apexvol-mcp/main/skills/options-analysis/SKILL.md

之后，每当出现期权分析问题时，Claude 都会自动加载该技能（同时也必须连接 MCP 服务）。

响应格式

所有工具都会返回包含 Markdown 摘要的结构化数据：

{
  "success": true,
  "data": { ... },
  "summary": "## AAPL IV Analysis\n\n| Metric | Value |\n...",
  "metadata": {
    "timestamp": "2025-01-08T10:30:00",
    "ticker": "AAPL"
  }
}

身份验证

本地模式使用基于令牌的身份验证；远程连接器使用 OAuth（使用你的 ApexVol 账户登录，无需处理令牌）。

令牌格式

• 前缀：avmcp_
• 总长度：38 个字符

获取令牌

所有付费 ApexVol 套餐（Basic $55/mo、Premium、Pro）均包含 API 和 MCP 访问权限。每个工具返回的数据层级与您的 Web 套餐相同；Pro 可解锁完整工具集。

1. 前往 apexvol.com/account → API Access 创建和管理令牌——签发、轮换和撤销均可自行操作。
2. 如有疑问或遇到问题，请联系：[email protected]。

每次请求都会发送令牌，因此请像对待密码一样妥善保管。如果令牌泄露，请在账户页面撤销并创建新令牌。

故障排除

先运行健康检查——它可以一次性诊断大多数问题：

APEXVOL_API_TOKEN=avmcp_YOUR_TOKEN_HERE apexvol-mcp --check

“API 令牌无效或缺失”

• 确认已正确设置 APEXVOL_API_TOKEN 环境变量
• 确认令牌尚未被撤销（请查看 apexvol.com/account → API Access）
• 检查令牌是否以 avmcp_ 开头

“请求超时”

• 检查您的网络连接
• ApexVol 平台可能暂时不可用

MCP 服务未加载

• 更改配置后，重启 Claude Code/Desktop
• 检查 apexvol-mcp 是否位于 PATH 中（which apexvol-mcp；pipx 安装会自动处理）
• 确认配置 JSON 语法有效

远程连接器无法授权

• 确认您的 ApexVol 账户拥有有效的付费套餐，然后移除并重新添加连接器
• 连接器 URL 必须准确为 https://apexvol.com/mcp-server（末尾不带斜杠）

开发

本地运行

# Install in development mode
pip install -e ".[dev]"

# Run the server directly
python -m apexvol_mcp.server

运行测试

pytest tests/

支持

如有问题或疑问：

• 电子邮件：[email protected]
• 文档：https://apexvol.com/docs/api
• 设置指南：https://apexvol.com/learn/claude-options-data-mcp

许可证

MIT——请参阅 LICENSE。客户端为开源；访问 ApexVol 平台本身仍需订阅。