GammaRips MCP 是一个面向 AI 智能体的期权流情报服务器，基于 MCP（Model Context Protocol）协议，为自带智能体的交易者提供数据原语，而非投资建议。其核心设计原则是“只给原语，不给选股”：没有“该买什么”的端点，每个智能体基于相同数据自行推理合约与退出规则。
用途与数据池 每个交易夜，GammaRips 对 3,532 只可期权美股按流动性排名，取前 100 只，保留看涨标的，并为每只定价一张虚值看涨期权，形成约 40 至 50 张合约的候选池。该池基于合约流动性筛选：自流动性规则上线（2026-08-24，1,301 张合约）以来，开仓兴趣中位数为 4,664，盘中成交量中位数为 1,039；此前 60 个扫描日分别为 906 和 232。最薄的 10% 合约仍保有 1,635 开仓兴趣，此前为 29。在 60 天研究中，美东时间 10:00 入场未成交率从 40.5% 降至 6.1%。
主要能力（9 个工具） V4（2026-07-17）将 V3 的 29 个工具整合为 9 个，被吸收的工具以 view= 或 granularity= 模式存在，web_search 已移除。 免费层（无需密钥）：get_pool（候选池，支持 enriched/raw/features/preview 视图）、get_regime_context（VIX/VIX3M/SPY 趋势及失效关闭状态轨）、get_market_calendar_status（NYSE 开闭市、扫描日期、数据新鲜度）、get_playbook（方法论与参考，含 start-here、daily-workflow、run-your-own-tournament、exit-lab、leakage-and-data-contract、changelog 及 schema）、get_daily_report（每日报告）。 Pro 层（Agent Access，29 美元/月密钥）：get_signal（单只标的详情或财报窗口检查）、get_liquidity（入场日流动性，单合约或整个池）、query_outcomes（结果与回执，支持 labels/summary/surface/harvest/exit_rule/signal_performance/win_rate/positions/performance 等视图）、replay_contract（原始价格带，分钟或日粒度，供自定义退出规则使用，服务器不模拟退出）。
使用方式 托管 MCP 端点：Streamable HTTP（主）https://mcp.gammarips.com/mcp；SSE（旧版，弃用窗口）https://mcp.gammarips.com/sse；无状态 JSON-RPC https://mcp.gammarips.com/jsonrpc；服务器卡片 https://mcp.gammarips.com/.well-known/mcp/server-card.json；OAuth 端点（聊天客户端）https://mcp.gammarips.com/pro。 认证：两种凭证，一套分层。API 密钥 gr_live_... 以 Authorization: Bearer <key> 或 X-API-Key 发送；OAuth 2.1 访问令牌由 gammarips.com 签发（聊天客户端）或由机器客户端以 client_credentials 铸造（无头智能体）。免费层工具在 /mcp 上无需凭证；4 个 Pro 工具需要有效订阅。 聊天客户端：在 ChatGPT、Claude（claude.ai / Desktop）等添加自定义连接器或远程 MCP 服务器，URL 为 https://mcp.gammarips.com/pro，客户端自动发现授权服务器并打开登录同意页，无需粘贴密钥。 无头智能体：在 gammarips.com/account 创建机器客户端（需 Agent Access），获得 client_id + client_secret（仅显示一次），每次运行前用 client_credentials 铸造一小时访问令牌并以 bearer 发送；机器客户端无刷新令牌，层级在每次铸造时从订阅重新读取。 插件安装：本仓库是 Open Plugins 标准插件（.cursor-plugin/plugin.json），捆绑托管 MCP 服务器及 gammarips-options-flow 技能，可从插件市场搜索“GammaRips”安装或让 Cursor 指向本仓库，默认免费层连接，添加 gr_live_... 密钥启用 Pro 工具。 手动配置：Cursor 在 Settings → MCP → Add new MCP server 或 .cursor/mcp.json 添加；Cline 在 MCP Servers → Remote Servers → Add 或 cline_mcp_settings.json 添加；免费层省略 headers。仅支持 SSE 的客户端可在弃用窗口使用旧版 /sse 端点。
适用场景与限制 适用于自带智能体的交易者，用于对候选池进行推理、设计退出规则、回放合约价格带、查询结果标签与表现回执。数据为模拟交易研究数据，仅供教育用途，不构成投资建议。引擎自身的每日选择不在同日发布；重置后实时队列可能合法为空（total_trades: 0 且聚合为 null 表示尚未累积已平仓交易，而非 0% 胜率）；policy_version="all" 会包含引擎已弃用的队列，不构成业绩记录。本地开发支持 Docker，服务器绑定 0.0.0.0:${PORT:-8080}，Streamable HTTP 位于 /mcp（SSE 回退）。部署为手动，使用 Cloud Run 源部署脚本，密钥通过 Secret Manager 挂载，切勿以明文环境变量传递。安全模型见 SECURITY.md，包括只读保证、参数化查询防 SQL 注入、响应大小限制、按 IP 限速、净化错误、防泄漏视图、列分类数据契约及 OAuth 2.1 资源服务器模型（本服务仅验证令牌，gammarips.com 为授权服务器）。
