StockScreen MCP サーバー

Yahoo!ファイナンスを通じて包括的な株式スクリーニング機能を提供するモデルコンテキストプロトコル（MCP）サーバー。LLMがテクニカル、ファンダメンタル、オプションの基準に基づいて株式をスクリーニングできるようにし、ウォッチリストの管理と結果の保存をサポートします。

特徴

株式スクリーニング

テクニカル分析スクリーニング
- 価格と数量フィルター
- 移動平均線（20、50、200 SMA）
- RSI指標
- 平均真の範囲（ATR）
- トレンド分析（1日、5日、20日の変化）
- MA距離計算
基礎スクリーニング
- 時価総額フィルター
- P/E比率分析
- 配当利回り基準
- 収益成長指標
- ETF固有の指標（運用資産残高、経費率）
オプションスクリーニング
- インプライドボラティリティ（IV）フィルター
- オプション取引量と建玉
- プット/コール比率分析
- ビッド・アスク・スプレッド評価
- 決算日の近接性チェック

データ管理

ウォッチリストの作成と管理
スクリーニング結果の保存
デフォルトのシンボルカテゴリ
- メガキャップ（2,000億ドル以上）
- 大型株（100億ドル～2,000億ドル）
- ミッドキャップ（20億ドル～100億ドル）
- 小型株（3億ドル～20億ドル）
- マイクロキャップ（3億ドル未満）
- ETF

インストール

# Install dependencies
pip install -r requirements.txt

# Clone the repository
git clone https://github.com/twolven/mcp-stockscreen.git
cd mcp-stockscreen

使用法

Claude 構成に追加します。claude claude-desktop-config.jsonで、 mcpServersセクションに以下を追加します。

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

「path/to/stockscreen.py」を、stockscreen.py ファイルを保存した場所へのフルパスに置き換えます。

利用可能なツール

run_stock_screen

技術審査基準

{
    "screen_type": "technical",
    "criteria": {
        "min_price": float,              # Minimum stock price
        "max_price": float,              # Maximum stock price
        "min_volume": int,               # Minimum average volume
        "above_sma_200": bool,           # Price above 200-day SMA
        "above_sma_50": bool,            # Price above 50-day SMA
        "min_rsi": float,                # Minimum RSI value
        "max_rsi": float,                # Maximum RSI value
        "max_atr_pct": float,            # Maximum ATR as percentage of price
        "category": str                  # Optional: market cap category filter
    },
    "watchlist": str,                    # Optional: name of watchlist to screen
    "save_result": str                   # Optional: name to save results
}

基本的なスクリーニング基準

{
    "screen_type": "fundamental",
    "criteria": {
        "min_market_cap": float,         # Minimum market capitalization
        "min_pe": float,                 # Minimum P/E ratio
        "max_pe": float,                 # Maximum P/E ratio
        "min_dividend": float,           # Minimum dividend yield (%)
        "min_revenue_growth": float,     # Minimum revenue growth rate
        "category": str,                 # Optional: market cap category filter
        
        # ETF-specific criteria
        "min_aum": float,                # Minimum assets under management
        "max_expense_ratio": float,      # Maximum expense ratio
        "min_volume": float              # Minimum trading volume
    },
    "watchlist": str,                    # Optional: name of watchlist to screen
    "save_result": str                   # Optional: name to save results
}

オプション画面の基準

{
    "screen_type": "options",
    "criteria": {
        "min_iv": float,                 # Minimum implied volatility (%)
        "max_iv": float,                 # Maximum implied volatility (%)
        "min_option_volume": int,        # Minimum options volume
        "min_put_call_ratio": float,     # Minimum put/call ratio
        "max_spread": float,             # Maximum bid-ask spread (%)
        "min_days_to_earnings": int,     # Minimum days until earnings
        "max_days_to_earnings": int,     # Maximum days until earnings
        "category": str                  # Optional: market cap category filter
    },
    "watchlist": str,                    # Optional: name of watchlist to screen
    "save_result": str                   # Optional: name to save results
}

ニューススクリーン基準

{
    "screen_type": "news",
    "criteria": {
        "keywords": List[str],           # Keywords to search for in news
        "exclude_keywords": List[str],    # Keywords to exclude from results
        "min_days": int,                 # Minimum days back to search
        "max_days": int,                 # Maximum days back to search
        "management_changes": bool,       # Filter for management changes
        "require_all_keywords": bool,     # Require all keywords to match
        "category": str                  # Optional: market cap category filter
    },
    "watchlist": str,                    # Optional: name of watchlist to screen
    "save_result": str                   # Optional: name to save results
}

カスタムスクリーン基準

{
    "screen_type": "custom",
    "criteria": {
        "category": str,                 # Optional: market cap category filter
        "technical": {
            # Any technical criteria from above
        },
        "fundamental": {
            # Any fundamental criteria from above
        },
        "options": {
            # Any options criteria from above
        },
        "news": {
            # Any news criteria from above
        }
    },
    "watchlist": str,                    # Optional: name of watchlist to screen
    "save_result": str                   # Optional: name to save results
}

カテゴリ値

フィルタリングに利用可能な時価総額のカテゴリー:

"mega_cap": >2000億ドル
「大型株」: 100億ドル～2,000億ドル
「ミッドキャップ」: 20億ドル～100億ドル
「small_cap」: 3億ドル～20億ドル
「マイクロキャップ」: <3億ドル
「etf」: ETF商品

manage_watchlist

{
    "action": str,                       # Required: "create", "update", "delete", "get"
    "name": str,                         # Required: watchlist name (1-50 chars, alphanumeric with _ -)
    "symbols": List[str]                 # Required for create/update: list of stock symbols
}

get_screening_result

{
    "name": str                          # Required: name of saved screening result
}

応答形式

テクニカルスクリーンレスポンス

{
    "screen_type": "technical",
    "criteria": dict,                    # Original criteria used
    "matches": int,                      # Number of matching stocks
    "results": [                         # List of matching stocks
        {
            "symbol": str,
            "price": float,
            "volume": float,
            "rsi": float,
            "sma_20": float,
            "sma_50": float,
            "sma_200": float,
            "atr": float,
            "atr_pct": float,
            "price_changes": {
                "1d": float,             # 1-day price change %
                "5d": float,             # 5-day price change %
                "20d": float             # 20-day price change %
            },
            "ma_distances": {
                "pct_from_20sma": float,
                "pct_from_50sma": float,
                "pct_from_200sma": float
            }
        }
    ],
    "rejected": [                        # List of stocks that didn't match
        {
            "symbol": str,
            "rejection_reasons": List[str]
        }
    ],
    "timestamp": str
}

クロードの使用プロンプト

株式スクリーニング機能を提供するストックスクリーンツールを有効にしました。主に3つの機能をご利用いただけます。

さまざまな基準タイプで株式をスクリーニングします。
- テクニカル指標: 価格、出来高、RSI、移動平均、ATR
- ファンダメンタルズ：時価総額、PER、配当、成長
- オプション: IV、出来高、決算日
- カスタム: 複数の条件タイプを組み合わせる
ウォッチリストを管理する:
- シンボルリストの作成と更新
- 既存のウォッチリストを削除する
- ウォッチリストの内容を取得する
保存されたスクリーニング結果にアクセスします。
- 前の画面の結果を読み込む
- 一致したシンボルと基準を確認する

すべての機能には、エラー処理、詳細な市場データ、包括的な対応が含まれます。

要件

Python 3.12以上
MCPサーバー
yファイナンス
パンダ
ナンピー
非同期

制限事項

データはYahoo Financeから取得しており、遅延の可能性があります
Yahoo Finance API 制限に基づくレート制限
オプションデータの利用可能時間は市場時間によって異なります
一部の財務指標は遅延または利用できない場合があります

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

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

著者

トッド・ウルブン - ( https://github.com/twolven )

謝辞

Anthropicのモデルコンテキストプロトコル（MCP）を使用して構築
データはYahoo Financeより提供
アントロピックのクロードとの使用のために開発されました

StockScreen MCP Server

Integrations

StockScreen MCP サーバー

特徴

株式スクリーニング

データ管理

インストール

使用法

利用可能なツール

利用可能なツール

技術審査基準

基本的なスクリーニング基準

オプション画面の基準

ニューススクリーン基準

カスタムスクリーン基準

カテゴリ値

応答形式

テクニカルスクリーンレスポンス

クロードの使用プロンプト

要件

制限事項

貢献

ライセンス

著者

謝辞

Appeared in Searches