JinDaGe - montewalk MCP Details

article

README

🚀 🏔️ MonteWalk

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

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

🚀 快速开始

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

点击上方的 Gradio 界面 即可：

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

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

技术栈

| 属性 | 详情 | |------|------| | 前端 | 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 |

🎓 了解更多

模型上下文协议：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

为交易社区用心打造 ❤️