Stockmcp

🚀 雅虎ファイナンスモデルコンテキストプロトコル（MCP） for LLaMA 3.2 3B

このリポジトリには、Yahoo Finance APIとLLaMA 3.2 3Bを統合したモデルコンテキストプロトコル（MCP）の実装が含まれています。このMCPにより、モデルはリアルタイムの金融データ、株式情報、市場ニュースを取得できるようになり、同時にLLaMAのすべての通常機能を維持します。

✨ 主な機能

• LLaMA 3.2 3B内で直接リアルタイムの株価を取得する
• 詳細な企業情報（業界、部門、時価総額など）を取得する
• カスタム可能な期間と間隔で過去の株式データを検索する
• 最新の市場ニュースの見出しを取得する
• 非金融関連のクエリを妨げることなく、LLaMAの機能をスムーズに拡張する

📦 インストール

前提条件

• Python 3.8以上
• Ollama - LLaMA 3.2 3Bをローカルで実行するために必要
• Ollamaを使用して取得したLLaMA 3.2 3Bモデル
• 必要なPythonパッケージ：
  • ollama
  • yfinance
  • requests
  • pandas

インストール手順

1. Ollama をインストールします。
2. Ollamaを使用してLLaMA 3.2 3Bモデルを取得します。

   ollama pull llama3.2:3b
   

3. このリポジトリをクローンします。

   git clone <repository-url>
   cd mcp_yahoo_finance
   

4. 必要なPython依存関係をインストールします。

   pip install -r requirements.txt
   

💻 使用例

基本的な使用法

Ollamaとの統合でMCPを実行する

Yahoo Finance MCPをOllama経由でLLaMA 3.2 3Bとともに使用するには、以下のコマンドを実行します。

python mcp_ollama_integration.py

これにより、対話型セッションが開始され、以下のことができます。

• 財務関連の質問をすると、Yahoo Financeのデータが充実した回答が得られます。
• 非財務関連の質問もできます。

コマンドラインオプション

• -h, --help：ヘルプ情報を表示して終了します。
• --port PORT：サービスが実行されるポートを指定します。デフォルトは8000です。

動作原理

MCPはアダプターとして機能し、LLaMAが外部データソース（Yahoo Finance）にアクセスできるようにします。特定の形式のクエリを傍受して処理することでこれを実現します。ユーザーがリアルタイムデータを必要とする質問をすると、MCPはYahoo Finance APIを呼び出して最新情報を取得し、それをモデルに返します。

高度な使用法

インストールが完了したら、ターミナルで以下のコマンドを実行します。

python mcp_ollama_integration.py

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

curl http://localhost:8000

🔧 トラブルシューティング

問題：サービスが起動しない

• Ollamaが正しくインストールされ、実行されていることを確認してください。
• モデルが正しく取得されていることを確認してください。

問題：Ollamaに接続できない

• Ollamaサービスが実行されていることを確認してください。
• ファイアウォールが関連するポートへのアクセスを許可していることを確認してください。

問題：API呼び出しが失敗する

• ネットワーク接続を確認してください。
• Yahoo Finance APIキーが有効であることを確認してください。

📄 注意事項

• このツールは研究および教育目的のみで使用されることを想定しています。
• 使用する前に、Yahoo Financeの利用規約とサービス契約を読んでください。

🤝 貢献者

このプロジェクトに貢献してくれたすべての方に感謝します！