pattern-vista

Name: pattern-vista
Author: xsf0221

本地服务

github.com/xsf0221金融数据01 周前更新

代码仓库

关于 pattern-vista

pattern-vista 是面向 AI Agent 和用户的命令行工具，可查询美国股票的 MA200 偏离排名、市场广度和 K 线形态历史胜率。默认输出 JSON，也可通过其 MCP 服务以工具形式访问同一数据。

主要功能

01查询高于或低于 MA200 的股票
02查看市场广度历史
03获取推荐形态及 20 日胜率
04查询单只股票报告
05JSON 默认输出并支持表格

适用场景

01筛选偏离 MA200 较远的股票
02查看市场整体高于 MA200 的比例
03检查股票形态信号的历史表现

MCP 相关

可通过 stdio 启动 MCP 服务，提供市场广度、偏离排名、推荐形态、股票报告和账户状态工具。MCP 服务与 CLI 使用相同的数据客户端，并使用 PATTERN_VISTA_API_KEY 或已保存的密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "xsf0221-pattern-vista": {
      "command": "uvx",
      "args": [
        "pattern-vista"
      ]
    }
  }
}

启动命令uvx pattern-vista

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypipattern-vista0.2.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Pattern Vista CLI

通过命令行访问 Pattern Vista——K 线形态的历史胜率和 MA200 偏离排名——让 AI Agent 和人类一样轻松调用。

输出默认为 JSON（Agent 可直接解析）；添加 --table 可查看适合人类阅读的视图。

安装

pip install pattern-vista     # or: uvx pattern-vista whoami

身份验证

在 https://www.pattern-vista.com（Account → API keys）生成密钥，然后：

pv config set-key pv_live_xxxxxxxx
# or, for ephemeral/agent use:
export PATTERN_VISTA_API_KEY=pv_live_xxxxxxxx

解析顺序：--api-key 标志 → PATTERN_VISTA_API_KEY → 已保存的配置。

命令

pv whoami                       # validate key, show account + tier
pv deviation --over --limit 20  # stocks furthest ABOVE their 200-day average
pv deviation --under            # stocks furthest BELOW (mean-reversion longs)
pv patterns --limit 20          # latest recommended patterns + 20-day win-rate
pv ticker AAPL                  # one symbol: current deviation + recent patterns
pv stretch --days 120           # market breadth: % of the universe above its MA200

# add --table to any command for human output:
pv deviation --under --table

示例（适合 Agent 的 JSON）

$ pv deviation --under --limit 3
{
  "is_billed": true,
  "rows": [
    {"ticker": "XYZ", "snapshot_date": "2026-05-27", "close": 41.2, "ma200": 58.9, "deviation": -0.3005},
    ...
  ]
}

免费版与付费版

免费账户只能查看每个列表的前 2 行，且无法查看形态的历史胜率。付费订阅可解锁完整列表（最多 100 项）和 hist_win_w20。服务器端根据密钥判定订阅等级——请查看每个响应中的 is_billed。

用于 Agent / 程序化调用

from pattern_vista import PatternVistaClient

pv = PatternVistaClient(api_key="pv_live_xxxx")
under = pv.deviation("under", limit=20)   # dict: {"is_billed": ..., "rows": [...]}
aapl = pv.ticker("AAPL")

PatternVistaClient 核心不依赖 CLI——下方的 MCP 服务基于它构建，因此两者返回的内容始终一致。

用作 MCP 服务

让 Agent 可直接调用相同数据的工具。如果你有 uv，无需安装：

{
  "mcpServers": {
    "pattern-vista": {
      "command": "uvx",
      "args": ["--from", "pattern-vista[mcp]", "pattern-vista-mcp"],
      "env": { "PATTERN_VISTA_API_KEY": "pv_live_xxxxxxxx" }
    }
  }
}

将其添加到 MCP 客户端的配置中（Claude Desktop、Claude Code、Cursor，或任何支持通过 stdio 使用 MCP 的客户端）。如果你更希望安装：

pip install 'pattern-vista[mcp]'   # then use "command": "pattern-vista-mcp"

或者在容器中运行。必须使用 -i——传输方式是 stdio，因此如果没有附加 stdin，服务就没有可读取的内容，会立即退出：

docker build -t pattern-vista-mcp .
docker run -i --rm -e PATTERN_VISTA_API_KEY=pv_live_xxxxxxxx pattern-vista-mcp

工具

工具	解答的问题
`market_stretch`	当前市场整体处于高位延伸还是低位承压状态？与自身历史相比排名如何？
`deviation_ranking`	哪些标的的价格最远低于（或高于）其自身 200 日均线？
`recommended_patterns`	昨晚的扫描标记了什么？该形态类别的历史表现是否优于 SPY？
`ticker_report`	某个标的的所有持仓信息。
`account_status`	此密钥属于哪个账户？该账户是否为付费等级？

身份验证解析方式与 CLI 完全相同：使用 PATTERN_VISTA_API_KEY，否则使用通过 pv config set-key 保存的密钥。订阅等级仍由服务器端判定——免费密钥只能获得 2 行，且 hist_win_w20 为 null，因此在将短列表视为市场平静之前，请先检查响应中的 is_billed。

兼容两代 MCP Python SDK（mcp 1.x 的 FastMCP 和 2.x 的 MCPServer）。

数据说明

偏离度 = (close − MA200) / MA200，每晚基于 S&P 500 + Nasdaq 100 + 主要 ETF 构成的范围刷新。排名前会过滤拆股造成失真的值和不合理的值。
市场广度（pv stretch、market_stretch）指同一范围内收盘价高于各自 MA200 的标的占比；每个交易日读取一次，并提供相应历史数据。所有等级均可免费使用——该数值与公开页面 https://www.pattern-vista.com/market/stretch 发布的相同。
胜率（hist_win_w20）指已结算的过去信号中，形态类型、方向和形态相同，且在随后 20 个交易日内表现优于 SPY 的占比——详见 https://www.pattern-vista.com/track-record 上列出的逐条信号记录。已结算信号不足 10 条时为 Null。
过去的表现不代表未来的结果。本内容不构成投资建议。