OptionsFlow MCP Server

OptionsFlow MCP

一个基于类型的 FastMCP 服务，可根据 Yahoo Finance 数据分析期权策略。它支持本地 stdio 和容器化 Streamable HTTP 传输方式。

工具

analyze_basic_strategies(symbol, strategy, expiration_date, delta_target=0.3, width_pct=0.05) 保留了原始公开工具名称、必需参数、默认值和策略取值：ccs、pcs、csp 和 cc。价格和收益值会区分每股金额与标准的 100 股合约乘数。结果包括盈亏平衡点、最大收益／亏损、资本回报率、根据实际盈亏平衡点计算的概率、持仓希腊值、数据提供方／时间元数据、警告和拒绝原因。

uv sync --locked
uv run python optionsflow.py

该服务使用 stdio，且不会向 stdout 写入与协议无关的内容。Black-Scholes 数值是理论上的欧式模型估算；股息和美式期权的提前指派可能导致其与实际结果存在显著差异。Yahoo Finance 是非官方的个人用途数据源，数据可能延迟、不完整、受到速率限制或发生结构性变化。返回的内容均非投资建议，也不保证是实时数据。

Docker / Streamable HTTP

容器以非特权用户身份运行，安装已锁定的生产依赖，并在 http://127.0.0.1:8000/mcp 提供 MCP 服务。使用以下命令启动：

docker compose up --build -d
Invoke-RestMethod http://127.0.0.1:8000/health

将支持 Streamable HTTP 的 MCP 客户端连接到 http://127.0.0.1:8000/mcp。为避免同时运行多个服务时端口冲突，请在启动 Compose 前设置 MCP_HOST_PORT，例如 $env:MCP_HOST_PORT=8001。使用 docker compose down 停止并移除容器。

Compose 映射有意绑定到 localhost。该端点没有身份验证或 TLS；若要将其暴露到不受信任的网络，必须先正确配置反向代理和访问控制。

仅绑定到环回接口并不意味着端点是私有的：浏览器仍可通过 DNS 重绑定访问它，因此服务会在请求到达 MCP 会话之前验证 Host 和 Origin 标头。携带外部 Host 的请求将收到 421 Misdirected Request 响应，携带外部 Origin 的请求将收到 403 Forbidden 响应；同源环回流量以及未发送 Origin 的非浏览器客户端不受影响。

变量	默认值	用途
MCP_TRANSPORT	stdio	stdio、http 或 streamable-http。
MCP_HOST	127.0.0.1	HTTP 服务绑定的接口。
MCP_PORT	8000	容器内的端口。
MCP_PATH	/mcp	Streamable HTTP 端点路径。
MCP_HOST_PORT	8000	Compose 在 127.0.0.1 上发布的主机端口。
MCP_HOST_ORIGIN_PROTECTION	true	true、auto 或 false。仅在代理执行相同验证时才禁用。
MCP_ALLOWED_HOSTS	未设置	允许出现在 Host 中的额外主机名，以逗号分隔。
MCP_ALLOWED_ORIGINS	未设置	允许出现在 Origin 中的额外浏览器来源，以逗号分隔。

将容器置于反向代理之后时，请把反向代理的主机名加入 MCP_ALLOWED_HOSTS，否则防护机制会拒绝代理转发的 Host。在 Docker 之外，运行 uv run python optionsflow.py 仍是兼容 stdio 的默认方式。

运行以下命令进行验证：uv lock --check、uv run ruff check .、uv run mypy .、uv run pytest、uv build 和 uv run python scripts/verify_wheel.py。CI 还会构建容器，并通过 Streamable HTTP 执行健康检查和 MCP 工具发现检查。领域／数据提供方分支覆盖率门槛为 90%。设置 YFINANCE_LIVE=1 可选择运行不对价格作断言的实时冒烟测试。