TradingView MCP 服务部署与 Hermes Agent 集成指南

tradingview-mcp 是一个基于 Model Context Protocol (MCP) 协议的 Python 原生金融数据与量化分析服务端(开源仓库:atilaahmettaner/tradingview-mcp)。它为 Hermes Agent 提供了 41+ 种金融分析工具,涵盖美股/A股/加密货币/期权/期货实时行情、布林带/RSI 扫描、大盘热力图、多 Agent 辩论及 Institutional 级 Walk-Forward 回测。


一、 核心部署方式 (Hermes Agent stdio 极速挂载)

在 Hermes Agent 所在的宿主机环境,Hermes 使用 Python uvx 运行时以 stdio (标准输入输出) 模式直连拉取 Python 包并启动 MCP 服务。

1. 运行环境依赖

  • Python 3.10 ~ 3.13(系统需已安装 uv 包管理器)
  • 验证 uvx 可用性:
    uvx --version

2. Hermes 配置文件挂载

编辑 Hermes 主配置文件 ~/.hermes/config.yaml,在 mcp_servers 节点下配置 tradingview 服务:

mcp_servers:
  tradingview:
    command: uvx
    args:
      - --from
      - git+https://github.com/atilaahmettaner/tradingview-mcp.git
      - tradingview-mcp
    enabled: true

🚀 启动速度优化说明

  • 移除 --refresh 参数:生产环境下切勿添加 --refresh 选项。移除后,uvx 将直接复用本地缓存(在 ~/.cache/uv/),避免每次 Agent 启动或调用时向 GitHub 发起网络 IO 校验,将 MCP 启动耗时从秒级降低至毫秒级
  • 每周自动更新机制:使用 Cronjob 每周定点清理旧缓存并拉取 Git 最新 HEAD Commit 进行预热,兼顾性能与时效性。

二、 每周自动更新与预热 SOP

为了确保 MCP 服务代码保持最新,同时不影响日常调用的毫秒级响应,已将 TradingView MCP 的更新逻辑整合至 Weekly 系统运维 Cronjob 中。

1. 手动更新命令

如需手动强制升级至 GitHub 最新代码:

# 1. 清理旧版 uv 缓存
uv cache prune
 
# 2. 强制拉取 Git 最新 HEAD 预热至本地缓存
uvx --refresh --from git+https://github.com/atilaahmettaner/tradingview-mcp.git tradingview-mcp --help

2. 定时任务整合

通过 Hermes cronjob 在每周日 04:00 (CST) 自动触发全量 Docker 容器平滑升级与 TradingView MCP 代码预热:

# 包含在 Weekly Cron (Job ID: 2cdc4b1937f4)
0 4 * * 0

三、 工具能力与 Agent 调用规则

挂载成功后,Hermes Agent 在启动时会自动注册 41 项原生 MCP 工具。核心高频工具如下:

工具名称功能描述典型调用场景
yahoo_price实时拉取美股/A股/ETF/加密货币价格“查一下 AAPL 和 QQQ 的最新现价”
coin_analysis标的单时间轴技术指标深度读数“对 NVDA 的 1h 日线做一次布林带与 RSI 读数”
multi_timeframe_analysis多时间轴趋势对齐 (W➔1D➔4H➔1H)“做一次 SOLUSDT 的多时间轴趋势共振分析”
stock_options_chain美股期权链 (Calls + Puts) 全量行情“拉取 QQQ 近期期权链数据”
stock_options_unusual_activity期权异动成交 (Volume/OI 比率)“检测当前美股期权大单异动”
walk_forward_backtest_strategy步进式 Walk-Forward 回测验证防过拟合“验证 QQQ RSI 策略在样本外的鲁棒性”

⚖️ 逆向防守与安全规则 (Inversion)

  1. 绝对只读防护tradingview-mcp 的所有工具均为 100% 只读分析工具,不包含任何资金交易接口,可安全授权 Agent 自主执行。
  2. 底层 WAF 防限流:批量调用 bollinger_scansmart_volume_scanner 时底层会自动进行请求频率控制,严禁 short-loop 短时间内高并发扫描,避免宿主机 IP 被 TradingView/Yahoo WAF 封禁。

相关链接