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より提供
アントロピックのクロードとの使用のために開発されました

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Yahoo!ファイナンスを通じて包括的な株式スクリーニング機能を提供します。LLMは、テクニカル、ファンダメンタル、オプションの基準に基づいて株式をスクリーニングでき、ウォッチリストの管理と結果の保存もサポートされます。

Related MCP Servers

findata-mcp-server
xBlueCode
A
security
F
license
A
quality
This is an MCP server that provides access to the Alpha Vantage API, allowing stock data retrieval to be used as context to LLMs.
Last updated -
2
15
6
JavaScript
StockFlow MCP Server
twolven
-
security
A
license
-
quality
A Model Context Protocol server providing real-time stock data and options analysis through Yahoo Finance, enabling LLMs to access market data, analyze stocks, and evaluate options strategies.
Last updated -
4
Python
MIT License
MCP LLMS.txt Explorer
thedaviddias
A
security
F
license
A
quality
A server that helps discover and analyze websites implementing the llms.txt standard, allowing users to check if websites have llms.txt files and list known compliant websites.
Last updated -
2
2
44
JavaScript
Yahoo Finance MCP for LLaMA 3.2 3B
Shak2000
-
security
F
license
-
quality
Integrates Yahoo Finance API with LLaMA 3.2 3B, allowing users to retrieve real-time stock prices, company information, historical data, and market news while maintaining the model's original capabilities.
Last updated -
Python

View all related MCP servers

StockScreen MCP Server