Yahoo Fianace MCP

Yahoo Finance MCP サーバー

このプロジェクトは、yfinance ライブラリのさまざまな関数を個別のツールとして公開する Model Context Protocol（MCP）サーバーを提供します。これにより、MCP クライアント（Claude Desktop など）から Yahoo Finance のデータを問い合わせることができます。

前提条件

• Python： Python がインストールされていることを確認してください（Python 3.8 以降を推奨）。
• uv： このプロジェクトでは、環境とパッケージの管理に uv を使用します。まだインストールしていない場合は、こちらの手順に従ってインストールしてください：https://github.com/astral-sh/uv

セットアップ

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

   git clone [email protected]:a05031113/yahoo-fianace-mcp.git
   cd yahoo-finance # Or your repository directory name
   

2. 仮想環境を作成します： 仮想環境の使用を強くおすすめします。uv を使用して作成します：

   uv venv
   

   .venv ディレクトリが作成されます。

3. 仮想環境を有効にします：

   • macOS/Linux の場合：

     source .venv/bin/activate
     

   • Windows（Git Bash/WSL）の場合：

     source .venv/Scripts/activate
     

   • Windows（コマンドプロンプト/PowerShell）の場合：

     .venv\Scripts\activate
     

   ターミナルのプロンプトの先頭に (.venv) が表示されます。

4. 依存関係をインストールします： uv を使用して必要な Python パッケージをインストールします：

   uv pip install -r requirements.txt
   

サーバーの実行

このサーバーは、MCP が想定する標準入力／出力（stdio）を介して通信します。サーバーを実行するには、有効化した仮想環境の Python インタープリターを使用して main.py スクリプトを実行するだけです：

python main.py

サーバーが起動し、標準エラー出力（stderr）にログメッセージを出力しながら、標準入力（stdin）で JSON-RPC リクエストを待ち受けます。

通常は、MCP クライアントの設定（設定 JSON ファイルなど）で、次のコマンドを実行するように指定します：

{
  "mcpServers": {
    "yahoo_finance_engine": {
      "command": "/path/to/your/yahoo-finance/.venv/bin/python", // Adjust path accordingly
      "args": [
        "/path/to/your/yahoo-finance/main.py" // Adjust path accordingly
      ]
    }
    // ... other servers
  }
}

その後、MCP クライアントがこのサーバープロセスの起動と通信を管理します。

利用可能なツール

このサーバーは、YahooFinance クラス（src/tool.py で定義）のパブリックメソッドを個別の MCP ツールとして公開します。以下はその一部です：

• get_current_stock_price(symbol: str)
• get_stock_price_by_date(symbol: str, date: str)
• get_stock_price_date_range(symbol: str, start_date: str, end_date: str)
• get_historical_stock_prices(symbol: str, period: str = "1mo", interval: str = "1d")
• get_dividends(symbol: str)
• get_income_statement(symbol: str, freq: str = "yearly")
• get_cashflow(symbol: str, freq: str = "yearly")
• get_balance_sheet(symbol: str, freq: str = "yearly")
• get_earning_dates(symbol: str, limit: int = 12)
• get_news(symbol: str)
• get_company_info(symbol: str)
• get_splits(symbol: str)
• get_recommendations(symbol: str)
• get_analyst_price_targets(symbol: str)
• get_major_holders(symbol: str)
• get_institutional_holders(symbol: str)
• get_mutualfund_holders(symbol: str)
• get_option_expiration_dates(symbol: str)
• get_option_chain(symbol: str, date: str)
• get_sustainability(symbol: str)

各ツールのパラメーターの詳細は、main.py または src/tool.py 内の docstring を参照してください。

MCP Review 認定済みです。 https://mcpreview.com/mcp-servers/a05031113/yahoo-fianace-mcp