Yahoo finance MCP server

MCP Yahoo Finance

Model Context Protocol（MCP）を使用して Yahoo Finance と連携する MCP サーバーです。このサーバーでは、株価や企業情報の取得、金融データの可視化を行うツールを利用できます。

このプロジェクトは、maxscheijen/mcp-yahoo-finance をフォークして拡張したもので、可視化機能を追加しています。

特徴

• 金融データ：現在の株価、過去の株価、配当、損益計算書などを取得できます
• ビジュアル分析：市場センチメント、ポートフォリオの追跡、テクニカル分析の見やすい可視化を生成します
• 簡単な連携：Claude Desktop、VS Code、Cursor などの MCP クライアントで動作します

セットアップ手順

1. リポジトリをクローンする

このリポジトリをローカルマシンにクローンします。

git clone https://github.com/leoncuhk/mcp-yahoo-finance.git
cd mcp-yahoo-finance

2. 依存関係をインストールする

pip を使用して必要な依存関係をインストールします。

pip install -r requirements.txt

requirements.txt ファイルがない場合は、依存関係を直接インストールできます。

pip install mcp yfinance pandas matplotlib seaborn plotly kaleido numpy pillow base64io

3. MCP クライアントを設定する

Claude Desktop

claude_desktop_config.json に以下を追加します（ファイルがない場合は作成してください）。

• macOS/Linux：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

docker を使用することもできます。

{
    "mcpServers": {
        "yahoo-finance": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "IMAGE"]
        }
    }
}

VSCode

.vscode/mcp.json に以下を追加します。

{
    "servers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

Cursor

Cursor の MCP 設定に以下を追加します。

{
    "mcp-servers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

4. MCP クライアントを再起動する

設定後、サーバーを読み込むために Claude Desktop または使用する MCP クライアントを再起動します。

利用可能なツール

基本的な金融データ

• get_current_stock_price：銘柄の現在の株価を取得します
• get_stock_price_by_date：指定した日付の株価を取得します
• get_stock_price_date_range：指定した期間の株価を取得します
• get_historical_stock_prices：期間を指定して過去の株価データを取得します
• get_dividends：銘柄の配当情報を取得します
• get_income_statement：損益計算書データを取得します
• get_cashflow：キャッシュフロー計算書データを取得します
• get_earning_dates：決算日情報を取得します
• get_news：銘柄の最近のニュースを取得します

可視化ツール

• generate_market_dashboard：主要指数のリアルタイムのパフォーマンスを示す市場センチメントダッシュボードを作成します
• generate_portfolio_report：ポートフォリオのパフォーマンス追跡レポートを生成します
• generate_stock_technical_analysis：銘柄のテクニカル分析レポートを作成します

可視化の例

市場センチメントダッシュボード

ポートフォリオの追跡

株価のテクニカル分析

プロンプトの例

Claude で試せるプロンプトの例を紹介します。

基本的な金融データ

1. 「Apple の現在の株価はいくらですか？」
2. 「Apple と Google の株価の差はいくらですか？」
3. 「2025-01-01 から 2025-3-31 までに Apple の株価はいくら変動しましたか？」

可視化のリクエスト

1. 「主要指数のパフォーマンスを示す市場センチメントダッシュボードを生成してください。」
2. 「AAPL、MSFT、GOOGL、AMZN、NVDA のテクノロジー株を対象に、ポートフォリオの追跡レポートを作成してください。」
3. 「移動平均線とサポート／レジスタンスの水準を含む、Tesla 株のテクニカル分析チャートを表示してください。」
4. 「S&P 500、Dow Jones、NASDAQ を含む市場センチメントダッシュボードを生成してください。」
5. 「XOM、CVX、BP、COP、SLB のエネルギー株を対象に、ポートフォリオレポートを作成できますか？」
6. 「RSI と出来高のパターンを示す、NVDA 株の詳細なテクニカル分析が必要です。」

テスト

可視化機能をテストするには、次のコマンドを実行します。

cd tests
python test_visualization.py

これにより、examples ディレクトリに可視化の例を示す画像が生成されます。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルを参照してください。

謝辞

• Max Scheijenによるオリジナルプロジェクト
• tooyipjeeに着想を得た可視化機能を追加