greeks-mcp 是一个 Model Context Protocol（MCP）服务器，将 Greeks 期权分析 API 以工具形式暴露给任意 MCP 客户端，包括 Claude Desktop、Cursor、Claude Code 等。用户可以直接向助手询问任意股票代码的 GEX、Greeks、Max Pain、异常期权流或完整仪表盘，服务器会实时从 API 拉取数据。该服务器仅暴露派生/计算后的分析数据，不重新分发原始市场数据。
主要能力：提供 17 个工具，覆盖 Greeks、GEX/DEX 与 gamma flip、Max Pain、异常期权流、IV 曲面、预期波动、期限结构、筛选器以及 GEX 热力图等期权分析功能。
使用方式：首先在 greeks.pro 注册并创建 API 密钥，密钥格式为 grk_<48 位十六进制>。公开工具（筛选器、健康检查、套餐）无需密钥即可使用。然后在 MCP 客户端配置中添加一个 mcpServers 块并重启客户端，助手即可获得全部 17 个工具。uv 会按需在隔离环境中下载并运行已发布的包，无需手动安装或更新。若偏好 pipx，可执行 pipx install greeks-mcp，然后使用 "command": "greeks-mcp" 且不带参数。仓库还包含 Dockerfile 用于容器化运行；服务器使用 stdio 通信，需以交互模式（-i）运行。镜像启动后无需密钥即可响应 MCP 内省（initialize + tools/list），GREEKS_API_KEY 仅用于需要认证的分析工具。将容器接入 MCP 客户端时，设置 "command": "docker" 和 "args": ["run","--rm","-i","-e","GREEKS_API_KEY","greeks-mcp"]。相同的 mcpServers 配置块适用于所有 MCP 客户端，仅文件位置不同；可直接复制的配置示例位于 examples/ 目录。重新加载后，服务器会出现在 Cursor 的 Settings → MCP 中，显示绿点及其 17 个工具；在聊天中输入 @greeks-analytics（或直接询问 GEX/greeks/max pain）即可使用。
工具参数：大多数分析工具接受 symbol（必填）和可选的 expiration（Unix 时间戳，或 "all" 表示所有到期日；省略则使用最近到期日）。get_greeks 还接受 range="atm"、moneyness="low,high" 和 limit。两个工具参数不同：get_gex_intraday 使用 date="YYYY-MM-DD"（而非 expiration），get_track_record_detail 仅接受可选的 symbol。
从源码运行：需要 Python ≥ 3.10。
发布（维护者）：通过 Trusted Publishing（OIDC，不存储 API 令牌）发布到 PyPI。一次性设置：在 PyPI → Account settings → Publishing 添加待发布者，项目 greeks-mcp，所有者 ArtBreguez，仓库 greeks-mcp，工作流 publish.yml，环境 pypi；在 GitHub 仓库设置 → Environments 中创建名为 pypi 的环境。然后通过提升 pyproject.toml 和 init.py 中的版本并推送标签来发布。工作流会构建 sdist+wheel，验证 wheel 可安装并注册全部 17 个工具，然后发布。
限制与错误：402 / 403 表示当前套餐不包含该路由（或触发了代码/速率限制）。可调用 list_plans 查看各套餐解锁的功能。expiration="all" 返回所有到期日，数据更丰富但更慢；对于热门标的，建议使用特定到期日时间戳，或提高 GREEKS_TIMEOUT。仅提供派生数据，不重新分发原始市场数据（报价、买卖价、未平仓合约、合约价格）。许可证为 MIT，详见 LICENSE。
