用途
ApexVol MCP Server 是一个 Model Context Protocol（MCP）服务器，让 AI 助手可以实时访问 ApexVol 的期权分析平台。提供商将其定位为面向 Claude Code、Claude Desktop、claude.ai（远程连接器，无需安装）以及任何兼容 MCP 的客户端的期权数据与分析工具入口。提供商自述共提供 44 个工具、一个连接器。
主要能力
提供商按类别列出可用工具：
- 期权链（6 个工具）：get_options_chain、get_expirations、get_options_by_delta、get_stock_price、calculate_expected_move、get_historical_chain。
- 波动率分析（7 个工具）：get_iv_rank、get_volatility_cone、get_volatility_risk_premium、get_term_structure、find_iv_opportunities、get_vix_snapshot、get_monies_surface。
- Greeks 与 GEX（5 个工具）：get_gex、get_charm_exposure、get_third_order_greeks、get_greeks_heatmap、get_cross_index_gex。
- 期权流向（3 个工具）：get_options_flow、get_smart_money_flow、scan_volatility_arb。提供商说明，市场关闭时流向数据为日终数据；若成交量数据源静默，会返回解释而非零值。
- 策略构建（5 个工具）：build_strategy、analyze_strategy、optimize_strategy、simulate_option_chain、calculate_probability_of_profit。
- 风险管理（4 个工具）：calculate_portfolio_greeks、run_scenario_analysis、generate_stress_tests、get_hedge_recommendations。持仓以 JSON 数组传入（ticker、position_type、quantity、strike、expiration、Greeks），需先通过 get_options_chain 获取期权 Greeks；纯股票组合可用纯文本（如 "AAPL 100 shares"）。
- 事件与筛选（5 个工具）：get_earnings_calendar、analyze_earnings_history、screen_market、get_market_overview、get_economic_calendar。
- 标的分析（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、get_zero_dte、get_orats_cores、search_tickers、scan_relative_value。
- 帮助与发现（1 个工具）：help。help() 列出数据族和提问方式；help("get_iv_rank")、help("gex") 或 help("/iv-rank/{ticker}") 返回对应工具、族或端点记录；其他词语执行搜索。提供商说明该工具使用内置数据、不消耗请求额度、在设置 token 前即可使用。
服务器还注册了 41 个提示词起始器（每个数据族三个，另加每个配方一个），会出现在 Claude Desktop、Cursor 和 VS Code 的提示词选择器中。
提供商提到 0.1.4 版本支持批量：calculate_expected_move 与 get_iv_rank 可一次传入最多 25 个标的，get_gex 可批量最多 25 个标的，get_options_flow 的 limit 与 detail 可控制行数大小，get_zero_dte 的 strikes_around 与 detail 可控制链的规模。
使用方式
提供商提供两种接入方式：
方式 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 也可使用远程服务器，然后在提示时进行身份验证（/mcp 命令显示登录状态）。
方式 B — 本地安装（stdio） 提供商建议使用 pipx 安装，以使 apexvol-mcp 命令隔离并始终位于 PATH 中；也可使用普通 pip install apexvol-mcp，或从源码安装。安装后可运行 apexvol-mcp --check 验证安装与 token 认证，该命令会打印客户端版本、认证结果以及剩余的速率限制/月度预算。
Claude Code（CLI）或 Claude Desktop 需通过配置文件接入。Claude Desktop 在 macOS 上编辑 ~/Library/Application Support/Claude/claude_desktop_config.json，在 Windows 上编辑 %APPDATA%\Claude\claude_desktop_config.json。配置后需重启 Claude Code 或 Claude Desktop 以加载 MCP 服务器。
环境变量与鉴权 本地模式使用 token 鉴权（APEXVOL_API_TOKEN 环境变量，token 以 avmcp_ 开头）；远程连接器使用 OAuth。提供商说明速率限制为每账户每分钟 60 次请求、每小时 1,000 次、每月 10,000 次，本地与远程模式共享。
适用场景
提供商列出的示例查询覆盖波动率分析（如 "What's the IV rank for AAPL?"、"Show me the volatility cone for SPY"）、期权链与 Greeks 查询、策略构建（如 iron condor、call spread）、风险管理（组合 Greeks、压力测试、对冲建议）以及市场概览与筛选。提供商还提到仓库附带一个 Agent Skill，用于教 AI 助手如何将这些工具组合成完整分析（波动率高估/低估评估、财报布局、卖方策略筛选、GEX 状态解读、策略压力测试），并包含解读阈值与错误处理；配合 Claude Code 时可将该 skill 复制到 skills 目录。
限制
- 访问需要任意付费 ApexVol 套餐（Basic 每月 55 美元起）。提供商说明每个工具返回与网页套餐相同的数据层级，Pro 解锁完整工具集。
- API 和 MCP 访问包含在每个付费 ApexVol 套餐中；token 在 apexvol.com/account → API Access 自助创建与管理。
- 提供商注明 token 随每个请求发送，应像密码一样对待；如泄露应在账户页面撤销并重新创建。
- 期权流向与 smart money flow 工具在市场关闭时返回日终数据；若成交量数据源静默，会返回解释而非零值。
- 客户端为开源（MIT 许可，见 LICENSE），但提供商说明对 ApexVol 平台本身的访问仍受订阅限制。
支持与文档
提供商提供以下资源：
- 设置指南：https://apexvol.com/learn/claude-options-data-mcp
- REST API 文档：https://apexvol.com/docs/api
- 单文件 API 参考（适配 LLM 上下文窗口）：https://apexvol.com/docs/api/apexvol-api.md
- 联系邮箱：support@apexvol.com
仓库中包含的条件、配置示例、环境变量与故障排查内容，本文仅依据资料原文整理，未列出的细节暂未提供。
