/ 目录 / 演练场 / maverick-mcp
● 社区 wshobson ⚡ 即开即用

maverick-mcp

作者 wshobson · wshobson/maverick-mcp

个人股票研究,39+ 工具覆盖技术分析、选股、回测、情绪分析——由 Tiingo、yfinance 和 FRED 驱动。

wshobson 的 maverick-mcp 是业余人士用的 Bloomberg 聊天终端。技术指标(RSI、MACD、支撑/阻力),Maverick/Bear 选股器,基于 VectorBT 的回测引擎配备 15+ 策略,投资组合跟踪,以及 LLM 驱动的研究。Tiingo 采用自带密钥的方式(免费层级);可选密钥可解锁网络搜索和更多模型。

为什么要用

核心特性

实时演示

实际使用效果

maverick.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "maverick": {
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "maverick": {
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "maverick": {
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "maverick": {
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "maverick",
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "maverick": {
      "command": {
        "path": "uvx",
        "args": [
          "maverick-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add maverick -- uvx maverick-mcp

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: maverick-mcp

对股票运行技术分析检查

👤 DIY 交易者、图表模式学习者 ⏱ ~10 min intermediate

何时使用: 建仓前,你想要看到指标但不想打开 TradingView。

前置条件
  • TIINGO_API_KEY — tiingo.com —— 免费层级适合休闲使用
步骤
  1. 拉取完整的技术指标
    在 TSLA 上运行 get_full_technical_analysis。RSI、MACD、关键移动平均线、支撑/阻力。✓ 已复制
    → 技术仪表板
  2. 用通俗语言解释
    现在是看涨、看跌还是中性?对信心程度要具体。✓ 已复制
    → 有理由支撑的观点
  3. 理性检查
    哪些假设可能是错的?论点最脆弱的地方在哪里?✓ 已复制
    → 诚实的自我批评

结果: 一个经过推理的技术观点,你可以对照自己的判断进行双重检查。

注意事项
  • 单纯技术面不是策略 — 行动前根据基本面和新闻进行交叉检查
  • 回测过度拟合 — 始终在样本外数据上验证
搭配使用: yahoo-finance

使用 Maverick 选股器筛选候选股

👤 寻找交易设置的交易者 ⏱ ~20 min intermediate

何时使用: 每周或每日筛选以获得新想法。

步骤
  1. 运行选股器
    运行 get_maverick_stocks —— 今天有哪些通过了?✓ 已复制
    → 候选列表
  2. 分类
    对前 10 个,分别运行 get_full_technical_analysis,并按设置质量排名。✓ 已复制
    → 带有原因的排名列表

结果: 从一致标准推导出来的简短观察清单。

回测策略想法

👤 想要快速反馈的策略开发者 ⏱ ~25 min advanced

何时使用: 你有一个想法,比如'RSI 穿过 50 且价格在 200DMA 之上',想在历史数据上看到效果。

步骤
  1. 运行回测
    run_backtest: RSI-cross-above-50 + price>200DMA, SPY, 2015-2024, 10bps slippage。✓ 已复制
    → 收益统计 + 最大回撤
  2. 与基线比较
    compare_strategies: 我的策略 vs 买入并持有 SPY,同期。✓ 已复制
    → 对比数据

结果: 一个有数据支撑的观点,看看这个想法是否可行。

分析你的纸质投资组合

👤 长期投资者 ⏱ ~20 min intermediate

何时使用: 季度审查:多样化、相关性、风险。

步骤
  1. 构建投资组合
    为 AAPL、MSFT、JNJ、VTI、GLD 运行 portfolio_add_position,按当前权重。✓ 已复制
    → 投资组合对象
  2. 相关性 + 风险
    portfolio_correlation_analysis 和 risk_adjusted_analysis。✓ 已复制
    → 矩阵 + 统计数据
  3. 建议
    哪些重叠?集中风险在哪里?✓ 已复制
    → 多样化建议

结果: 有依据支持的可行性再平衡想法。

组合

与其他 MCP 搭配,撬动十倍杠杆

maverick + yahoo-finance

将 maverick 的技术面与 Yahoo 的原始基本面相结合

获取 TSLA 的 maverick 技术分析,加上 Yahoo 财务报表,并综合出一个论题。✓ 已复制
maverick + notion

将研究备忘录保存到 Notion

在 AVGO 上运行 research_comprehensive;将输出保存为 Notion 页面,位置在 Investing / Research 下。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
fetch_stock_data ticker, start, end, interval? 基础数据获取 1 Tiingo call
get_full_technical_analysis ticker: str 一站式技术视图 multiple calls
get_maverick_stocks (none) 每周筛选 free (pre-seeded DB)
run_backtest strategy, ticker, start, end, params 验证策略想法 CPU-bound
portfolio_add_position ticker, shares, cost_basis 跟踪持仓 free
portfolio_correlation_analysis (none) 多样化检查 CPU
research_comprehensive ticker: str 深入研究;成本更高 LLM + web search calls
analyze_market_sentiment ticker or sector 价格之外的背景信息 web search calls

成本与限制

运行它的成本

API 配额
Tiingo 免费层级:500 req/hr, 50k/mo。如果用于研究,还取决于 OPENROUTER/Anthropic 密钥。
每次调用 Token 数
简单数据:500-2000。research_comprehensive:10k+
费用
免费层级适合业余使用;付费数据 + LLM 密钥用于重度研究
提示
启用 Redis 缓存以避免重复的 Tiingo 调用;OpenRouter 相比直接使用 Anthropic 在 LLM 调用上节省 40-60%。

安全

权限、密钥、影响范围

凭据存储: 环境变量:TIINGO_API_KEY、OPENROUTER_API_KEY 等。
数据出站: 调用 Tiingo、Yahoo(通过 yfinance)、FRED,以及任何你配置的 LLM/搜索密钥
切勿授予: 将 HTTP 传输暴露到公网

故障排查

常见错误与修复

TIINGO_API_KEY 缺失

在 tiingo.com 创建免费账户并设置环境变量。

验证: echo $TIINGO_API_KEY
回测挂起

VectorBT 受 CPU 限制;分钟线的长历史可能需要 10+ 分钟。缩小日期范围或使用日线。

Redis 无法连接

Redis 是可选的;取消设置 REDIS_HOST 以回退到内存缓存。

验证: redis-cli ping

替代方案

maverick-mcp 对比其他方案

替代方案何时用它替代权衡
yahoo-finance-mcp你只需要原始数据,不需要技术分析/回测没有选股器、没有回测、没有投资组合
QuantConnect Lean / Zipline你需要机构级回测没有 MCP;设置更复杂
TradingView你想要图表 UI不是编程方式;不是 MCP

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills