💹 MCP YFinance Stock Server

💹 MCP YFinance 株価サーバー

このプロジェクトは、Yahoo Finance (YFinance) API を利用し、MCP (Model Control Protocol) とシームレスに統合できるように構築された株価サーバーをセットアップします。

AI エージェントやクライアントは、次のことができます。

• リアルタイムの株価データを取得する
• ウォッチリストを管理する
• 株式を詳細に分析する
• テクニカル指標をすべて実行する
• さらに多くのことを行う

---

🪙 まずはシンプルに：暗号資産価格トラッカーを作ってみましょう

本格的な株価サーバーに取り組む前に、Python + MCP で作られたシンプルな暗号資産トラッカーから始めることをおすすめします 👇

🔗 GitHub リポジトリ： https://github.com/Adity-star/mcp-crypto-server

次のことを学べます。

• MCP を使って get_price("BTC") などの暗号資産ツールを公開する
• FastAPI で API を構築する
• Alpaca API を使ってリアルタイム価格を取得する

🔗 関連プロジェクト

私のほかのプロジェクトもご覧ください。

• GenAI-Learnings：生成 AI の概念、ツール、プロジェクトを深く掘り下げます。
• LangChain-Mastery：強力な LLM アプリケーションを構築するために LangChain を習得するためのすべてが含まれています。
• Complete Data Science：データサイエンスと AI の概念、ツール、プロジェクトを深く掘り下げ、学習や面接準備のための資料をすべて提供します。
• Reinforcement-Learning：強化学習の実践的な実験と理論を紹介します。
• CompleteRAG：検索拡張生成（RAG）システムをエンドツーエンドで実装します。

---

📈 次のステップ：yFinance 株価サーバーを作りましょう

一連の流れに慣れたら、より高度な株価トラッカーに進みましょう 💹

🔗 GitHub リポジトリ： https://github.com/Adity-star/mcp-yfinance-server

📝 詳細なブログ： 👉 Python、yFinance、そして少しのオタク的な情熱で自分だけの株価サーバーを作った方法

含まれる機能：

• ウォッチリスト
• ほぼリアルタイムの価格更新
• テクニカルサマリー
• フル機能のダッシュボード
• トレンドおよびモメンタム指標
• ウォッチリスト管理

---

📦 ステップ 1：環境をセットアップする（uv を使用）

プロジェクト環境の管理には、モダンで非常に高速な Python パッケージマネージャーである uv を使用します。

🛠️ インストールとセットアップ

ターミナルで次のコマンドを実行します。

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh 

# Create and navigate to your project directory
mkdir mcp-yfinance-server
cd mcp-yfinance-server

# Initialize a new project
uv init

# Create and activate the virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

📥 プロジェクトをインストールする

依存関係を設定した pyproject.toml の準備ができたら、次を実行します。

#  Run 
uv pip install -e .

---

🚀 ステップ 2：MCP サーバーを起動する

環境の準備ができたら、株価サーバーを起動します。

uv run main.py

🧪 まず簡単にテストしてみますか？ 最初にツールを確認してみましょう。

python run test_server_fun.py

📄 サーバー全体の仕組みが気になりますか？

ソースコードはこちらからご覧ください。

🔗 yf_server.py › GitHub

---

🛠️ MCP ツールリファレンス

このサーバーは、AI エージェントや CLI ユーザー向けに多くのツールを提供しています。
重要なツールをいくつかご紹介します。ツールの全リストはこちらをご覧ください。

📦 ツール一覧

ツール名	説明
add_to_watchlist	個人用ウォッチリストに株式のティッカーを追加します。
analyze_stock	1か月間のテクニカルなトレンド分析を実行します（RSI、MACD、移動平均線）。
get_technical_summary	指標とシグナルを含む、包括的なテクニカルサマリーを生成します。
get_watchlist_prices	ウォッチリストに登録されたすべてのティッカーの最新価格を取得します。
get_trend_analysiss	最近のトレンドの変化、パターン、乖離を分析します。
get_stock_price	指定されたティッカーシンボルの現在価格を取得します。
get_volatility_analysis	過去のボラティリティとATR指標を計算します。
compare_stocks	2銘柄の株価を比較します（相対パフォーマンス分析に便利です）。

✅ 株式を精密に分析・監視するための強力なツールが合計18種類あります。

🧠 使用例

これらのツールは、次の用途に最適です。

• 📊 動的なウォッチリスト管理
• 🔁 トレンドとモメンタムの検出
• 📈 投資判断のための詳細なテクニカル分析
• ⚠️ ボラティリティに基づくリスク評価
• 🤖 株式に特化した自律型エージェントやダッシュボードの構築

⚙️ MCP サーバーを使ってインテリジェントな金融アプリケーションを構築する際は、このリファレンスを手元に置いておきましょう。

---

🔍 ステップ 3：MCP サーバーを調べる

MCP Server Inspector を使って、MCP ツールを簡単に確認・テストできます。 ターミナルで次のコマンドを実行します。

$ mcp dev source/yf_server.py

次の操作ができるインタラクティブなUIが起動します。

• 🧰 利用可能なすべてのツールとリソースを表示する
• 📥 各ツールの入力／出力をテストする
• 📡 サーバーからのリアルタイム応答を監視する

---

⚙️ ステップ 4：MCP サーバーを設定する

YFinance MCP サーバーを統合するには、mcp.config.json ファイルに次のエントリを追加します。

{
  "mcpServers": {
    "yfinance-price-tracker": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/YOUR/mcp-yfinance-server",
        "run",
        "main.py"
      ]
    }
  }
}

⚠️ /ABSOLUTE/PATH/TO/... を実際のファイルパスに置き換えてください。 💡 ヒント：分かりやすくするため、サーバー名を crypto-price-tracker から yfinance-price-tracker に変更してください。

---

🔁 ステップ 5：Claude Desktop を再起動する

Claude Desktop（またはMCPを使用する任意のインターフェース）を再起動して、新しいYFinanceツールを再読み込みし、有効化します。

これにより、更新されたMCP設定が認識され、すべての株式追跡ツールを すぐに使用できるようになります。

---

✅ ステップ 6：Claude Desktop で MCP サーバーをテストする

• すべてのインストールと設定が完了したら、Claude Desktop でMCPサーバーをテストできます。

次のクエリ例を使って、MCP YFinance Server の動作をテストします。

「TeslaとAppleの株価を比較してください。」 → 🔧 compare_stocks を使用

「過去1か月間のTeslaの履歴データを取得してください。」 → 📊 get_stock_history を使用

「Apple、Tesla、Relianceをウォッチリストに追加してください。」 → 📋 add_to_watchlist を使用

「過去30日間のApple株価チャートを表示してください。」 → 🖼️ Claudeはサーバーを使ってデータを取得し、可視化できます

📷 チャートの例： 🖼 スクリーンショットを表示

🌐 Claudeのライブサイト： Claude.siteでデモを開く

🧪 これらのテストにより、データ取得からリアルタイム分析、可視化まで、MCPの統合がエンドツーエンドで正しく動作していることを確認できます。

---

📊 結果

⚙️ 期待できる成果

機能	成果
✅ 株式分析	株価、OHLC、リターン、出来高、インサイト、データを含む株式分析を行います。
📈 テクニカル分析	RSI、MACD、MA などの指標を利用し、包括的なテクニカル分析の概要を確認できます。
📉 ボラティリティレポート	ATR とボラティリティ指標を使って、株式のリスクを分析します。
🔍 トレンド分析	株価の動きを分析して、トレンドの変化やダイバージェンスを検出します。
🧠 可視化	18 種類以上のツールを活用して、AI エージェントやダッシュボードで株式データを可視化できます。
📋 テクニカルチャート	株式のテクニカル指標をリアルタイムで分析・監視します。
🖼️ ビジュアルインサイト	Claude Desktop でチャートや視覚的な概要を生成します。

🎉 株価追跡ボットやインテリジェントな金融ダッシュボードを構築しませんか？このプロジェクトには、必要な中核機能がすべて揃っています。

---

📫 フィードバックと貢献

貢献を歓迎します！バグの修正、機能の追加、ドキュメントの改善など、皆さまの協力がこのプロジェクトをより良いものにします。

🐛 問題の報告

バグを見つけた場合や提案がある場合は、Issues セクションで issue を作成してください。次の内容を必ず含めてください。

• ✅ 再現手順（該当する場合）
• 🔍 期待される動作と実際の動作
• 📷 スクリーンショットまたはエラーログ（該当する場合）

📬 プルリクエストの送信

修正や改善のアイデアがありますか？Pull Requests セクションにアクセスして、PR を送信してください。できるだけ早く確認し、マージします！

---

💬 プロジェクトを広める

このプロジェクトのおかげで API のレート制限や高額な SaaS ツールを避けられたなら……

• 🌟 リポジトリにスターを付ける
• 🍴 フォークして、自分だけの暗号資産／株式ツールを作る
• 📲 @AdityaAkuskar を X でメンションする — 何を作ったのかぜひ見せてください！
• 🔗 LinkedIn でつながる

---

📜 ライセンス

MIT © 2025 Ak Aditya.

---

🚀 一緒に、より良いツールを作りましょう。

ツイートスレッドやカルーセル、このプロジェクトのローンチ投稿が必要なら、お任せください 😎