Montewalk

🚀 🏔️ MonteWalk

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

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

🚀 快速开始

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

点击上方的 Gradio 界面 即可：

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

选项 2：本地运行

前提条件

• Python 3.12 +
• Alpaca 模拟交易账户（免费）
• NewsAPI 密钥（可选，每天 100 次免费请求）

安装

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 密钥不提交到代码库
• 仓位限制：每笔交易设置硬编码风险检查
• 审计日志：完整记录操作，带有时间戳

📚 详细文档

• API 参考：完整的工具文档及示例
• .env.example：配置模板

🏗️ 架构

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 忽略）

技术栈

🎓 了解更多

• 模型上下文协议：modelcontextprotocol.io
• Gradio 6 文档：gradio.app/docs
• Alpaca 模拟交易：alpaca.markets/docs/trading/paper-trading

🙏 致谢

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

特别感谢：

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

📄 许可证

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

🔗 链接

• GitHub：github.com/N-lia/MonteWalk
• Hugging Face 空间：huggingface.co/spaces/N-lia/MonteWalk
• MCP 一周年：huggingface.co/spaces/launch/mcp-1st-bday

为交易社区用心打造 ❤️