shield_lock
金大哥
← 返回 MCP 目录
public公开dns本地运行

montewalk

MonteWalk是一个基于MCP协议的机构级量化交易工具服务器，为AI助手提供实时市场数据、投资组合管理、风险分析和回测功能，包含25+工具和6个智能工作流，通过Gradio 6界面提供专业交易终端体验。

article

README

🚀 🏔️ MonteWalk

MonteWalk 是一款为 AI 智能体打造的机构级量化交易工具，专为 MCP 一周年黑客松 而构建，能有效解决零售交易员面临的市场数据处理难题。

License: MIT MCP Compatible Gradio 6

📊 MCP 服务器统计信息：
🛠️ 25 + 种工具 | 📡 4 种资源 | 🎯 6 种智能提示

🚀 快速开始

选项 1：在 Hugging Face Spaces 上试用（推荐）

点击上方的 Gradio 界面 即可：

  1. 探索仪表盘和工具箱。
  2. 查看 MCP 客户端设置说明。
  3. 直接在浏览器中测试工具。

选项 2：本地运行

前提条件

安装

git clone https://github.com/N-lia/MonteWalk.git
cd MonteWalk
python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

配置

cp .env.example .env
# 编辑 .env 文件，填入你的 API 密钥：
# ALPACA_API_KEY=your_key
# ALPACA_SECRET_KEY=your_secret
# NEWSAPI_KEY=your_key (可选)

运行

# Gradio 界面 + MCP 服务器
uv run app.py

# 或纯 MCP 服务器（用于 Claude 桌面端）
uv run server.py

选项 3：连接到 Claude 桌面端

1. 添加到 claude_desktop_config.json：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "montewalk": {
      "command": "/absolute/path/to/MonteWalk/.venv/bin/python",
      "args": ["/absolute/path/to/MonteWalk/server.py"]
    }
  }
}

2. 重启 Claude 桌面端

3. 开始使用 MonteWalk：

  • “我的投资组合风险如何？”
  • “分析苹果公司的技术指标和市场情绪”
  • “对微软公司进行 10/50 均线交叉回测”
  • “运行早间简报”

✨ 主要特性

🔌 MCP 集成

可连接到 Claude 桌面端、VSCode 或任何 MCP 兼容客户端，为你的 AI 提供：

  • 实时市场数据（股票、加密货币、新闻）
  • 投资组合管理与执行
  • 风险分析与回测
  • 智能工作流程与自动化

🎨 精美的 Gradio 6 界面

通过精致专业的用户界面测试所有工具，具备以下特点：

  • 实时仪表盘：投资组合、自选股、加密货币趋势、新闻资讯
  • 交互式工具箱：直接访问 25 + 种交易工具
  • MCP 客户端设置：复制粘贴配置即可立即连接
  • 暗黑主题：时尚的玻璃质感设计，带有流畅动画

🧠 智能工作流程

预建提示可引导 AI 完成复杂的多步骤分析：

  • 早间简报：投资组合回顾、市场扫描、风险检查
  • 伽马狩猎：发现异常市场活动并深入研究热门股票
  • 股票分析：全面研究（基本面、技术面、市场情绪）
  • 投资组合再平衡：使用现代投资组合理论优化权重

📊 市场情报

  • 多源数据：整合雅虎财经、Alpaca、CoinGecko 等数据，并进行缓存以提高速度
  • 加密货币支持：实时价格、热门币种、全面市场数据
  • 新闻聚合：采用 yfinance → NewsAPI → GNews 备用管道
  • 情绪分析：通过 Modal 使用 FinBERT 进行金融情绪评分
  • 异常活动扫描器：检测大幅波动、成交量激增、反转候选股

📈 高级可视化

  • K 线图：专业的 OHLC 图表，带有成交量柱状图
  • 交互式图表：支持折线图、柱状图、直方图、散点图、热力图
  • 暗黑主题：图表风格与界面匹配，采用自定义调色板
  • Base64 编码：图表以可嵌入图像形式返回，便于 AI 处理
  • 工具集成：关键函数中可选 visualize 参数

⚡ 模拟交易引擎

  • 10 万美元虚拟资金：在 Alpaca 模拟交易平台上无风险测试策略
  • 智能执行：模拟滑点和交易成本
  • 交易前风险检查：防止投资组合集中度超过 50%
  • 仓位管理：即时查看投资组合并一键平仓

🛡️ 机构级风险分析

  • 风险价值（VaR）：在任何置信水平下进行历史模拟
  • 蒙特卡罗预测：基于 GBM 的投资组合路径模拟
  • 波动率指标：年化投资组合标准差
  • 回撤分析：跟踪最大峰谷跌幅

🔬 专业回测

  • 滚动优化分析：样本外验证，防止过拟合
  • 策略实验室：测试均线交叉、自定义指标等任何逻辑
  • 交易成本：模拟真实的滑点和费用

📈 技术分析套件

  • 智能信号：自动给出买入/卖出/中性建议
  • 20 + 种指标：包括 RSI、MACD、布林带、简单移动平均线等
  • 投资组合优化：均值 - 方差、风险平价算法

🎯 智能自选股

  • 自动同步：检测未在自选股中的持仓股票并提示添加
  • 实时价格：实时更新跟踪股票的价格
  • 新闻资讯：聚合所有关注资产的头条新闻

🎨 UI/UX 展示

MonteWalk 拥有专业设计的 Gradio 6 界面，专为交易员优化：

首页

  • 英雄板块：通过功能卡片清晰展示价值主张
  • 玻璃质感设计：现代暗黑主题，带有微妙透明度
  • 流畅导航：即时页面切换，支持返回顶部

仪表盘

  • 四面板布局：投资组合、自选股、加密货币、新闻，一目了然
  • 一键刷新：同时更新所有数据源
  • 响应式设计：在桌面和平板电脑上均可无缝使用

工具箱

  • 按类别组织：9 个工具组，可折叠显示
  • 动态表单：根据函数签名自动生成
  • 清晰结果：格式化输出，带有语法高亮

设置

  • API 配置：通过密码字段安全管理凭证
  • 即时反馈：清晰的成功/错误消息
  • 重启提示：指导用户应用更改

🔧 技术细节

基于 Gradio 6 构建

  • 原生 MCP 支持：demo.launch(mcp_server=True) 实现无缝集成
  • 自定义主题：使用 gr.themes.Base 实现专业暗黑调色板
  • 高级 CSS：玻璃质感效果、自定义动画、响应式网格
  • 导航状态：多页面单页应用体验，支持可见性控制

MCP 架构

  • 25 + 种工具：涵盖 9 个类别，提供全面的交易工具包
  • 4 种资源：实时投资组合、自选股、新闻、加密货币资讯
  • 6 种提示：引导复杂多步骤分析的工作流程
  • 错误恢复：自动备用方案和优雅降级

数据管道

  • 缓存策略：市场数据请求设置 5 分钟 TTL
  • 多源备用：yfinance → NewsAPI → GNews → CoinGecko
  • FinBERT 情绪分析：通过 Modal 端点进行无服务器 GPU 推理
  • 本地存储：基于 JSON 持久化投资组合和自选股

可视化系统

  • Matplotlib + Seaborn：专业图表，采用暗黑主题
  • 6 种图表类型：K 线图、折线图、柱状图、直方图、散点图、热力图
  • mplfinance 集成：专业 K 线图渲染，带有成交量
  • Base64 图像：图表编码为可用于 AI/网页的格式
  • 工具集成：关键函数中可选 visualize 参数

市场扫描器

  • 3 种扫描类型：大幅波动、成交量激增、反转候选股
  • 实时数据：由 Alpaca 市场数据 API 提供支持
  • 智能过滤：可配置阈值和限制
  • 可视化支持：扫描结果以柱状图展示

安全保障

  • 仅模拟交易：零真实资金风险
  • 环境变量：API 密钥不提交到代码库
  • 仓位限制：每笔交易设置硬编码风险检查
  • 审计日志：完整记录操作，带有时间戳

📚 详细文档

🏗️ 架构

MonteWalk/
├── app.py              # Gradio 6 界面 + MCP 服务器
├── server.py           # 纯 MCP 服务器（标准输入输出）
├── theme.py            # 自定义 Gradio 主题
├── config.py           # 环境配置
├── tools/              # 25 种交易工具
│   ├── market_data.py
│   ├── execution.py
│   ├── risk_engine.py
│   ├── backtesting.py
│   ├── feature_engineering.py
│   ├── portfolio_optimizer.py
│   ├── news_intelligence.py
│   ├── watchlist.py
│   ├── crypto_data.py
│   └── ...
├── resources/          # 教育资料
└── data/               # 本地存储（git 忽略）

技术栈

| 属性 | 详情 | |------|------| | 前端 | Gradio 6.0、自定义 CSS、谷歌字体 | | MCP | FastMCP、标准输入输出/HTTP 协议 | | 数据 | yfinance、Alpaca SDK、CoinGecko、NewsAPI | | 分析 | NumPy、SciPy、Pandas、pandas_ta | | 情绪分析 | FinBERT（Modal 无服务器 GPU） | | 部署 | Hugging Face Spaces、Python 3.12 |

🎓 了解更多

🙏 致谢

本项目由 N-lia 为 MCP 一周年黑客松 打造。

特别感谢：

  • Anthropic 提供的模型上下文协议规范
  • Gradio 出色的用户界面框架和 MCP 支持
  • Alpaca 提供的免费模拟交易基础设施
  • Modal 提供的无服务器 GPU 推理服务

📄 许可证

本项目采用 MIT 许可证，详情请见 LICENSE。

🔗 链接

为交易社区用心打造 ❤️

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载，用户一般按页面提供的连接方式或授权流程接入，不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖，把 server_config 复制到 MCP 客户端，并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端