YFinance トレーダー MCP ツール

Claude デスクトップ用 YFinance Trader MCP ツール

Claude Desktop 向けに特別に調整された、yfinance ライブラリを使用して株式市場データと取引機能を提供する MCP (Model Context Protocol) ツールです。

クレジット：このプロジェクトは、Luigi Ajah氏によるmcp-stocks （カーソルの類似実装）に触発されました。この改良版では、オリジナルのコンセプトをClaude Desktopで動作するように修正しています。

チュートリアル

このツールの設定と使用に関する詳細なガイドについては、Mediumチュートリアルをご覧ください。チュートリアル: Claude DesktopとYFinance Trader MCPツールを使用してリアルタイムの株式市場データにアクセスする

特徴

リアルタイム株価
企業情報と財務指標
過去の価格データ
シンボル検索機能
アナリストの推奨事項
インサイダー取引追跡

設定

Python 3.10以降がインストールされていることを確認してください
依存関係をインストールします:

pip install -r requirements.txt

Claude Desktopとの統合

次の内容を MCP 構成に追加して、Claude Desktop で MCP 設定を構成します。

{
  "mcpServers": {
    "yfinance-trader": {
      "command": "py",
      "args": ["-3.13", "path/to/your/main.py"]
    }
  }
}

パスをmain.pyファイルへのフルパスに置き換えます。
必要に応じてClaude Desktopを再起動してください

利用可能なツール

1. get_stock_quote

リアルタイムの株価情報を入手:

{
    "symbol": "AAPL",
    "price": 150.25,
    "change": 2.5,
    "changePercent": 1.67,
    "volume": 1234567,
    "timestamp": "2024-03-20T10:30:00"
}

2. 会社概要を取得する

企業情報と主要指標を取得します。

{
    "name": "Apple Inc.",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "marketCap": 2500000000000,
    "peRatio": 25.4,
    "forwardPE": 24.2,
    "dividendYield": 0.65,
    "52WeekHigh": 182.94,
    "52WeekLow": 124.17
}

3. get_time_series_daily

過去の日次価格データを取得します。

{
    "symbol": "AAPL",
    "timeSeriesDaily": [
        {
            "date": "2024-03-20T00:00:00",
            "open": 150.25,
            "high": 152.30,
            "low": 149.80,
            "close": 151.75,
            "volume": 12345678
        }
        // ... more data points
    ]
}

4. 検索シンボル

株式およびその他の証券を検索:

{
    "results": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc.",
            "type": "EQUITY",
            "exchange": "NASDAQ"
        }
        // ... more results
    ]
}

5. get_recommendations

株式に関するアナリストの推奨を取得します。

{
    "symbol": "AAPL",
    "recommendations": [
        {
            "period": "2024-03-15T00:00:00",
            "strongBuy": 15,
            "buy": 20,
            "hold": 8,
            "sell": 2,
            "strongSell": 0
        }
        // ... more periods
    ]
}

6. get_insider_transactions

インサイダー取引情報を入手する:

{
    "symbol": "AAPL",
    "transactions": [
        {
            "date": "2024-03-15T00:00:00",
            "insider": "John Doe",
            "position": "Director",
            "transactionType": "Buy",
            "shares": 1000,
            "value": 150250.00,
            "url": "https://finance.yahoo.com/...",
            "text": "Purchase of 1000 shares",
            "startDate": "2024-03-15",
            "ownership": "Direct"
        }
        // ... more transactions
    ]
}

サンプルクエリ

Claude Desktop に次のような質問をすることができます:

「AAPL の現在の株価と日々の変化はいくらですか？」
「マイクロソフト（MSFT）の会社概要を教えていただけますか？」
「過去 3 か月間の Tesla (TSLA) の過去の価格データを表示してください。」
「『NVDA』に関連する株式を検索します。」
「Amazon (AMZN) に対するアナリストの推奨事項は何ですか?」
「最近、Google (GOOGL) にインサイダー取引はありましたか？」

暗号通貨サポート

特別なティッカー形式を使用すると、限定された暗号通貨データが利用可能になります。

ビットコインのBTC-USD
イーサリアムのETH-USD
ドージコインのDOGE-USD

エラー処理

すべてのツールには適切なエラー処理が組み込まれており、何か問題が発生した場合にはエラーメッセージを返します。

{
    "error": "Failed to fetch quote for INVALID_SYMBOL"
}

トラブルシューティング

Claude Desktop で MCP サーバーが動作していない場合:

サーバーが実行中であることを確認してください。スクリプトを開始すると出力が表示されます。
設定のパスが正しく絶対パスであることを確認してください
Python 3.10+がシステムPATHにあることを確認してください
すべての依存関係がインストールされていることを確認する
Claude Desktopを再起動してみてください
ログにエラーメッセージがないか確認する

オリジナルのmcp-stocksプロジェクトとの違い

FastAPIの代わりにMCPライブラリを直接使用します
カーソルの代わりにClaude Desktopに適応
エラー処理と応答形式の変更
更新された構成アプローチ

ライセンス

MITライセンス

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

yfinanceライブラリを使用して株式市場データと取引機能を提供します

Related MCP Servers

Stock Market MCP Server
MCP-100
-
security
F
license
-
quality
A TypeScript-based MCP server that fetches real-time stock market data and company financial information through the Alpha Vantage API.
Last updated -
JavaScript
Yahoo Finance MCP Server
narumiruna
A
security
A
license
A
quality
A simple MCP server for Yahoo Finance using yfinance. This server provides a set of tools to fetch stock data, news, and other financial information.
Last updated -
10
20
Python
MIT License
Global MCP Stock Server
sakura-ku
-
security
F
license
-
quality
Provides real-time access to global stock market data including current prices, historical charts, and company financial information through a Model Context Protocol (MCP) server for AI assistants.
Last updated -
TypeScript
MCP Yahoo Finance
maxscheijen
A
security
A
license
A
quality
A Model Context Protocol server that enables interaction with Yahoo Finance to retrieve stock pricing, company information, and historical financial data through natural language queries.
Last updated -
9
2
Python
MIT License

View all related MCP servers

YFinance Trader MCP Tool