Finance_mcp_server

Finance_mcp-server

Yahoo Finance を通じて大規模言語モデルにリアルタイムの金融データを提供する Model Context Protocol（MCP）サーバーです。

このプロジェクトでは、Claude などの AI モデルが Yahoo Finance API を通じてリアルタイムの株価や金融データにアクセスできる MCP サーバーを作成します。このサーバーは Model Context Protocol 標準を実装しており、Claude Desktop、Cursor、Winds AI など、さまざまな MCP クライアントとシームレスに連携できます。

🚀 機能

• リアルタイムの株価検索：上場企業の現在の株価を取得します
• 過去データの分析：任意の期間の株価パフォーマンスを取得します
• 企業情報：詳細な企業プロフィールと財務指標にアクセスします
• 株式の比較：さまざまな指標に基づいて複数の株式を比較します
• 株式検索：企業名やキーワードから関連する株式を見つけます
• リソースアクセス：構造化された URI スキームを使用して金融データにアクセスします

📋 要件

• Python 3.9 以上
• yfinance パッケージ
• mcp パッケージ

💻 インストール

1. このリポジトリをクローンします：

   git clone https://github.com/dino65-dev/Finance_mcp-server.git
   

2. 仮想環境を作成します：

   python -m venv venv
   On Windows: venv\Scripts\activate
   

作成時間を短縮するには、仮想環境の作成をおすすめします：

pip install uv
uv venv
On Windows: venv\Scripts\activate

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

🔧 使い方

サーバーの実行

次のコマンドを実行してサーバーを起動します：

python yfinance_mcp_server.py

サーバーは、MCP プロトコルを介して通信する stdin/stdout プロセスとして実行されます。

MCP クライアントとの連携

Claude Desktop

1. Claude Desktop を開きます
2. 設定に移動します
3. 次の内容で MCP 設定を追加します：

   {
     "mcpServers": {
       "yfinance": {
         "command": "python",
         "args": [
           "/absolute/path/to/yfinance_mcp_server.py"
         ]
       }
     }
   }
   

4. Claude Desktop を保存して再起動します

Cursor

1. Cursor を開き、設定にアクセスします
2. MCP セクションに移動します
3. 次の設定で新しいグローバル MCP サーバーを追加します：

   {
     "yfinance": {
       "command": "python",
       "args": [
         "/absolute/path/to/yfinance_mcp_server.py"
       ]
     }
   }
   

4. 新しいチャットを開始して、金融ツールを使用します

📊 利用可能なツール

サーバーでは、次のツールを利用できます：

1. get_stock_price：現在の株価を取得します

   Example: Get the current price of Apple stock
   

2. get_historical_data：過去の価格データを取得します

   Example: Get the stock history for TSLA over the past 3 months
   

3. get_stock_metric：特定の財務指標にアクセスします

   Example: What is Amazon's market capitalization?
   

4. compare_stocks：指標に基づいて複数の株式を比較します

   Example: Compare the P/E ratios of Google, Microsoft, and Apple
   

5. search_stocks：名前やキーワードから株式を見つけます

   Example: Find stocks related to artificial intelligence
   

🔍 リソース URI

リソース URI を通じて、株式情報に直接アクセスできます：

• finance://SYMBOL/info - 株式の基本情報を取得します

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルをご覧ください。

🙏 謝辞

• 金融データを提供する Yahoo Finance
• Python API を提供する yfinance
• MCP 仕様を提供する Anthropic

📞 貢献

貢献を歓迎します！お気軽に Pull Request を送信してください。