Pattern Vista CLI 是 Pattern Vista 服务的命令行接口，主要面向 AI 智能体和程序化调用场景，提供 K 线形态历史胜率与 MA200 偏离度排名数据。其核心客户端 PatternVistaClient 不依赖 CLI，同时支撑 MCP 服务器，确保两种调用方式返回的数据完全一致。
用途方面，该工具提供三类数据：一是偏离度（Deviation），计算公式为 (close − MA200) / MA200，每个交易日夜间刷新，覆盖标普 500、纳斯达克 100 及主要 ETF 的股票池，并在排名前过滤掉因拆股扭曲或不可信的值；二是市场广度（pv stretch、market_stretch），即同一股票池中收盘价高于各自 MA200 的股票占比，每个交易日一个读数，并附带历史数据，该数据对所有层级免费，与公开页面 https://www.pattern-vista.com/market/stretch 发布的数据相同；三是胜率（hist_win_w20），即某形态类型自 2025-01-01 以来的 20 个交易日历史命中率，方法论见 https://www.pattern-vista.com/posts/pattern-alpha-backtest。
使用方式上，用户需先在 https://www.pattern-vista.com 生成 API 密钥（Account → API keys）。认证解析顺序为：--api-key 标志 → PATTERN_VISTA_API_KEY 环境变量 → 存储的配置。默认输出 JSON，添加 --table 可输出人类可读视图。作为 MCP 服务器使用时，若已安装 uv 则无需额外安装，配置方式为将相应配置放入 MCP 客户端（如 Claude Desktop、Claude Code、Cursor 等支持 stdio 传输的 MCP 客户端）的配置中；也可安装或通过容器运行，容器运行时必须加 -i 参数，因为传输方式为 stdio，没有附加的 stdin 服务器会立即退出。MCP 模式下的认证解析与 CLI 完全一致。该工具兼容两代 MCP Python SDK（mcp 1.x 的 FastMCP 和 2.x 的 MCPServer）。
适用场景主要是 AI 智能体或程序化系统获取市场技术面数据，用于解析、分析或展示。限制方面：免费账户每个列表仅可见前 2 行，且形态数据不包含 hist_win_w20（值为 null），付费订阅可解锁完整列表（最多 100 行）和 hist_win_w20；订阅层级由服务器端根据密钥强制执行，应在响应中检查 is_billed 字段，避免将过短的列表误判为市场平静。历史表现不代表未来结果，该工具不构成投资建议。
