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

為交易社區用心打造 ❤️