optionality-mcp

optionality-mcp

面向 AI 评判的期权交易练习游戏，提供 MCP 服务和 React 练习界面。基于 FastMCP 构建。

Optionality 是 Tollbooth-DPYC™ 服务的一个实例：通过便捷的 Don't Pester Your Customer™（DPYC™）Bitcoin 商务模式，将用户参与度变现。用户通过 Lightning 预存余额，无需为每次请求单独完成支付流程。所有价格均为动态价格，由运营方设定 — 欢迎页面会显示实时报价。用户还可以输入 Tollbooth-DPYC 优惠券，享受优惠活动折扣。

一轮练习如何进行

1. 庄家发牌。 庄家 大模型会编写完整的期权情景：股票代码、现价、IV 状态与偏斜、宏观背景、催化因素、关键价位和限制条件 — 还可以包括策略必须满足的最大亏损预算。
2. 你提出策略。 用自由文本表达，就像向资深 PM 提案一样。可以采用多腿结构、单腿策略，或有意选择观望 — 拒绝交易也是合理且可评分的答案。
3. 裁判评分。 裁判 大模型会将你的提案解析为结构化腿部策略，从六个维度进行评分，并提出一个可叠加到风险图表上的替代结构。

六个评判维度： 策略选择、行权价与期限、风险/回报、宏观因素整合、尾部风险和沟通表达 — 每项 0–20 分，汇总为 0–100 分，并对应从 A+ 到 F 的字母等级。

核心教学理念 — 烟幕弹

每个情景都会在叙述中穿插 1–2 条事实确凿但无关紧要的信息，绝不特别标明。引用这些信息作为交易依据会受到扣分；识别出它们只是噪声并搁置一旁，则能获得加分。这项练习旨在训练你从满是噪声的行情带中辨别信号，其中你读到的一切都是真的。

每次评估都会附带一份 事实清单：列出你整合了哪些情景事实、遗漏了哪些事实、识别出了哪些烟幕弹，以及被哪些烟幕弹误导。

情景模式与难度

三种历史真实性模式：

• 历史虚构 — 真实且可识别的市场时刻（SVB 周、英国国债危机），以当日的实际宏观环境和 IV 状态为背景
• 虚构 — 自创的市场状态：反事实冲击、脱锚连锁反应、Gamma 挤压
• 实时事件 — 基于网络搜索，以本周实际行情为依据并附有来源的情景

四种难度角色： 学徒、熟练者、行家、至尊。排行榜积分会根据难度加权，因此无法靠简单模式刷高排名。重来一次模式可以重新体验已评判过的情景。

期权数学 — 唯一真实来源

服务会根据庄家的框架构建完整的期权链 — 三个到期日、围绕现价排列的行权价梯级，以及遵循看跌期权买价偏斜的三个锚点 IV 微笑 — 并使用 Black–Scholes 为其定价。客户端运行相同的数学逻辑，因此练习者、图表和裁判看到的数字完全一致。

• 期权链弹窗采用经纪商惯例：左侧看涨期权，中间为行权价和微笑曲线，右侧为看跌期权；点击中间价即可买入或卖出；实时显示净权利金
• 风险曲线图显示到期盈亏、盈亏平衡标记，以及 DTE 滑块；滑动即可重现持仓期间的 Theta 损耗
• 裁判替代方案叠加层可将你的收益曲线与裁判会采用的结构进行比较

苏格拉底式线索台

情景进行中，随时提问。教育类问题会得到直接且有公式依据的回答；策略类问题则会引导你关注更值得思考的维度 — 决策责任仍由练习者承担。线索台绝不会透露情景中隐藏的事实或烟幕弹。使用线索会导致扣分。

日志、排行榜与同伴学习

• 日志 — 持久保存每一轮：未完成的草稿、已提交的策略、包含腿表和图表的完整评估
• 排行榜 — 六种排序方式（加权平均、加权最佳、原始平均、原始最佳、连胜、已玩局数），可按模式和难度筛选
• 连胜 — 连续得分达到 70+ 的记录，包含当前和历史最佳
• 共享条目 — 可选择分享已评估的回合，让其他人研究策略、评分和账本
• 个人资料 — 显示名称、头像、简介
• 用量 — 透明度选项卡，显示各模型的令牌消耗、各工具的支出以及赞助者的账户账单

可选的 Nsec 托管

使用不支持 NIP-07 签名器的设备（比如 iPad）的赞助者，可以选择让 Optionality 托管仅用于游戏的 nsec，并代其签署 Nostr 私信。escrow_nsec 会存入新生成的 nsec（必须派生出赞助者的 npub），并对其进行静态加密且绑定到该 npub；send_patron_dm 使用它代赞助者签署并发布私信；get_escrow_status 会说明是否托管了密钥；withdraw_nsec 会一次性返回 nsec 并将其删除，之后赞助者可在自己的 Nostr 客户端中保管密钥。使用 NIP-07 签名器进行自我托管则无需这些操作。

仓库布局

optionality-mcp/
├── server.py    # FastMCP server (Python) → Horizon
├── tools/       # dealer, judge, journal, leaderboard, profile, options chain, nsec escrow
├── db/          # Neon persistence (journal, leaderboard, patrons, usage, migrations)
├── llm.py       # server-side LLM client (operator's vaulted llm_api_key)
├── prompts.py   # dealer / judge / clue-desk personas
├── modal_app.py # detached runner for the LLM drills (Modal)
└── frontend/    # React 19 + Vite + TS UI → Cloudflare Pages

耗时较长的大模型工具（发牌、裁判、提示台）采用 claim-check 异步模式：调用会立即返回一个 claim，客户端随后轮询免费的 fetch 工具，因此耗时较长的生成任务不会因客户端超时而中断。运维人员提供 Modal 凭据后，这些任务会在 Modal 上分离运行（modal_app.py），而不是运行在 MCP 主机上。

DPYC 生态系统

optionality-mcp 是 DPYC 联邦中的一个 Operator——由多个独立 MCP 服务组成，共享 Nostr 身份模型、Bitcoin Lightning 支付和 tollbooth-dpyc SDK。相关仓库：

仓库	角色
tollbooth-dpyc	Python SDK——保险库、身份验证、定价、Lightning、Nostr 身份
dpyc-community	治理注册表：成员资格、公告、威胁模型
dpyc-oracle	社区服务台（免费入门指导 + 成员查询）
tollbooth-authority	认证骨干服务（Schnorr 签名证书）
tollbooth-sample	示例 Operator（规范模板）
tollbooth-pricing-studio	iOS 定价模型编辑器 / Operator 控制台
cypher-mcp	付费图谱查询：基于 Neo4j/AuraDB 的命名 Cypher 模板
schwab-mcp	Charles Schwab 经纪业务数据
thebrain-mcp	TheBrain 个人知识图谱
excalibur-mcp	X/Twitter 发帖
taxsort-mcp	税务分类 + Cloudflare Pages 界面
optionality-mcp	期权交易练习游戏（本仓库）
goodearth-mcp	面向小型农场、按地区划分的气候分析
beesknees-mcp	The Bee's Knees：多人竞速抢蜂后
roastify-mcp	Roastify 咖啡目录和包装艺术设计
ChartRemotely-mcp	远程将证券添加到桌面图表中
tollbooth-web	Operator 前端共用的浏览器 SDK
tollbooth-oauth2-collector	OAuth2 回调处理程序（倡导者服务）
tollbooth-shortlinks	URL 缩短工具

License

Apache 2.0 — see LICENSE and NOTICE.