🚀 🏔️ MonteWalk
AIエージェント向けの機関レベルの定量的トレードツールです。

📊 MCPサーバーの統計情報:
🛠️ 25以上のツール | 📡 4つのリソース | 🎯 6つのエージェント型プロンプト
🚀 クイックスタート
オプション1: Hugging Face Spacesで試す(推奨)
上のGradio UIをクリック して以下を行います:
- ダッシュボードとツールボックスを探索する
- MCPクライアントのセットアップ手順を表示する
- ブラウザ内で直接ツールをテストする
オプション2: ローカルで実行する
前提条件
インストール
git clone https://github.com/N-lia/MonteWalk.git
cd MonteWalk
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
設定
cp .env.example .env
実行
uv run app.py
uv run server.py
オプション3: Claude Desktopに接続する
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 Desktopを再起動します
3. MonteWalkの使用を開始します:
- "私のポートフォリオのリスクはどれくらいですか?"
- "AAPLのテクニカル分析とセンチメント分析を行ってください"
- "MSFTに対する10/50 MAクロスオーバーをバックテストしてください"
- "モーニングブリーフィングを実行してください"
✨ 主な機能
🔌 MCP統合
Claude Desktop、VSCode、またはMCP互換のクライアントに接続して、AIに以下を提供します:
- リアルタイムの市場データ(株式、暗号通貨、ニュース)
- ポートフォリオ管理と実行
- リスク分析とバックテスト
- インテリジェントなワークフローと自動化
🎨 美しいGradio 6インターフェイス
洗練されたプロフェッショナルなUIを通じてすべてのツールをテストできます。以下の特徴があります:
- ライブダッシュボード:ポートフォリオ、ウォッチリスト、暗号通貨トレンド、ニュースフィード
- インタラクティブなツールボックス:25以上のトレードツールへの直接アクセス
- MCPクライアントセットアップ:即座に接続するためのコピー&ペースト設定
- ダークテーマ:スムーズなアニメーションを持つスリークなグラスモーフィズムデザイン
🧠 エージェント型ワークフロー
複雑な多段階分析をAIに導く事前構築されたプロンプトです:
- モーニングブリーフィング:ポートフォリオレビュー、市場スキャン、リスクチェック
- ガンマハント:異常な市場活動を見つけ、上位の選択肢を深掘りする
- ティッカー分析:包括的な調査(基本分析、テクニカル分析、センチメント分析)
- ポートフォリオリバランシング:現代のポートフォリオ理論を使用してウェイトを最適化する
📦 インストール
前提条件
インストール手順
git clone https://github.com/N-lia/MonteWalk.git
cd MonteWalk
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
設定
cp .env.example .env
💻 使用例
基本的な使用法
uv run app.py
uv run server.py
高度な使用法
Claude Desktopに接続する場合:
{
"mcpServers": {
"montewalk": {
"command": "/absolute/path/to/MonteWalk/.venv/bin/python",
"args": ["/absolute/path/to/MonteWalk/server.py"]
}
}
}
Claude Desktopを再起動した後、以下のようなコマンドを使用できます:
- "私のポートフォリオのリスクはどれくらいですか?"
- "AAPLのテクニカル分析とセンチメント分析を行ってください"
- "MSFTに対する10/50 MAクロスオーバーをバックテストしてください"
- "モーニングブリーフィングを実行してください"
📚 ドキュメント
- APIリファレンス: サンプル付きの完全なツールドキュメント
- .env.example: 設定テンプレート
🔧 技術詳細
Gradio 6で構築
- ネイティブMCPサポート:
demo.launch(mcp_server=True) でシームレスな統合を可能にします
- カスタムテーマ:
gr.themes.Base を使用したプロフェッショナルなダークパレット
- 高度なCSS: グラスモーフィズムエフェクト、カスタムアニメーション、レスポンシブグリッド
- ナビゲーション状態: マルチページSPAエクスペリエンスのための可視性制御
MCPアーキテクチャ
- 25以上のツール: 9つのカテゴリにまたがる包括的なトレードツールキット
- 4つのリソース: ライブポートフォリオ、ウォッチリスト、ニュース、暗号通貨フィード
- 6つのプロンプト: 複雑な多段階分析のためのガイド付きワークフロー
- エラー回復力: 自動フォールバックとグレースフルデグラデーション
データパイプライン
- キャッシュ戦略: 市場データリクエストに5分のTTLを設定
- マルチソースフォールバック: yfinance → NewsAPI → GNews → CoinGecko
- FinBERTセンチメント: Modalエンドポイントを介したサーバーレスGPU推論
- ローカルストレージ: JSONベースのポートフォリオとウォッチリストの永続化
可視化システム
- Matplotlib + Seaborn: ダークテーマのプロフェッショナルなチャート
- 6種類のチャート: ローソク足チャート、折れ線チャート、棒グラフ、ヒストグラム、散布図、ヒートマップ
- mplfinance統合: 出来高付きの専用ローソク足レンダリング
- Base64画像: AI/Webでの消費のためにエンコードされたチャート
- ツール統合: 主要な関数にオプションの
visualize パラメーター
市場スキャナー
- 3種類のスキャン: 大きな値動き、出来高急増、反転候補
- リアルタイムデータ: Alpaca市場データAPIによって提供されます
- スマートフィルタリング: 設定可能な閾値と制限
- 可視化サポート: スキャン結果の棒グラフ
セキュリティと安全性
- 紙取引のみ: 実際のお金のリスクはゼロ
- 環境変数: APIキーはコードにコミットされません
- ポジション制限: すべての取引に対するハードコードされたリスクチェック
- 監査ログ: タイムスタンプ付きの完全なアクション履歴
🌍 実世界での影響
MonteWalkは、個人トレーダーや開発者に対して機関レベルの定量的ファイナンスを民主化します。
個人トレーダー向け
- 実践による学習: 10万ドルの仮想資本で戦略を練習する
- リスク教育: リアルタイムでVaR、ドローダウン、ボラティリティを理解する
- 時間節約: AIパワードのワークフローで調査を自動化する
- より良い意思決定: 基本分析、テクニカル分析、センチメント分析を組み合わせる
開発者向け
- MCPテンプレート: 金融ツールサーバーの参照実装
- Gradioのベストプラクティス: Gradio 6を使用したプロフェッショナルなUIパターン
- API統合: マルチソースデータ集約の例
- テストフレームワーク: 戦略検証のための安全な紙取引環境
AIアシスタント向け
- コンテキスト強化: Claude/GPTに金融の超常能力を与える
- エージェント型ワークフロー: 複雑な多段階トレード戦略を有効にする
- リアルタイムデータ: LLMをライブ市場情報に接続する
- ツールオーケストレーション: MCPの構成可能性のポテンシャルを示す
潜在的な拡張機能
- ライブトレード: 本番用のAlpaca統合(紙取引から簡単に切り替え可能)
- 高度な戦略: オプション、先物、アービトラージの実装
- ソーシャルトレード: 成功したエージェントワークフローを共有してクローンする
- 教育プラットフォーム: AIによるインタラクティブな金融コース
🎨 UI/UX紹介
MonteWalkは、トレーダー向けに最適化されたプロフェッショナルに設計されたGradio 6インターフェイスを備えています。
ランディングページ
- ヒーローセクション: 機能カード付きの明確な価値提案
- グラスモーフィズムデザイン: 微妙な透明度を持つモダンなダークテーマ
- スムーズなナビゲーション: ページトップへのスクロールで即座にページ遷移する
ダッシュボード
- 4パネルレイアウト: ポートフォリオ、ウォッチリスト、暗号通貨、ニュースを1つのビューにまとめる
- ワンクリックリフレッシュ: すべてのデータソースを同時に更新する
- レスポンシブデザイン: デスクトップとタブレットでシームレスに動作する
ツールボックス
- カテゴリ別に整理: 折りたたみ可能なアコーディオン付きの9つのツールグループ
- 動的フォーム: 関数シグネチャから自動生成される
- 明確な結果: 構文ハイライト付きのフォーマットされた出力
設定
- API設定: パスワードフィールドを持つ安全な資格情報管理
- 即時フィードバック: 明確な成功/エラーメッセージ
- 再起動プロンプト: 変更の適用方法をユーザーに案内する
🏗️ アーキテクチャ
MonteWalk/
├── app.py # Gradio 6 UI + MCPサーバー
├── server.py # 純粋なMCPサーバー(stdio)
├── 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/ # ローカルストレージ(gitignored)
テクノロジースタック
- フロントエンド: Gradio 6.0、カスタムCSS、Googleフォント
- MCP: FastMCP、stdio/HTTPプロトコル
- データ: yfinance、Alpaca SDK、CoinGecko、NewsAPI
- 分析: NumPy、SciPy、Pandas、pandas_ta
- センチメント: FinBERT(ModalサーバーレスGPU)
- デプロイメント: Hugging Face Spaces、Python 3.12
🎓 詳細を学ぶ
🙏 謝辞
このプロジェクトは、N-liaによってMCP 1st Birthday Hackathonのために構築されました。
特別な感謝を以下の組織に送ります:
- Anthropic:Model Context Protocolの仕様提供
- Gradio:素晴らしいUIフレームワークとMCPサポート
- Alpaca:無料の紙取引インフラストラクチャ
- Modal:サーバーレスGPU推論
📄 ライセンス
MITライセンス - 詳細は LICENSE を参照してください。
🔗 リンク
トレードコミュニティのために愛を込めて作られました ❤️