Yahooファイナンスバック技術、基本、オプション、ニュース、カスタム、およびウォッチリストのスクリーニングのためのタイプされたFastMCPサーバー。 ローカルstdioとコンテナ化された Streamable HTTP トランスポートをサポートしています。

ツール

• [run_stock_screen(screen_type, criteria, watchlist=None, save_result=None)]
• [get_stock_news(symbol, days_back=30)
• [manage_watchlist(action, name, symbols=None)
• [get_screening_result(name)

レガシー入力と5つのオリジナル画面カテゴリが保持されます。 未知の基準は、黙って無視されるのではなく拒否されます。 テクニカル画面は、元の価格、ボリューム、SMA-50/SMA-200、RSI、およびATR基準をサポートしています。 基本画面には、最小/最大市場キャップ、P/E、配当、収益成長、利益率、借金/等、価格/本、AUMの費用、比率、数量が含まれます。 オプション画面には、IV、オプションのボリューム、パット/コール比、スプレッド、有効期限、および収益デイバインドが含まれます。 ETF、ニュース、ネストされたカスタム基準は、元の名前を保持します。 明示的なシンボルまたはウォッチリストが優先されます。 サーバは、yfinance の文書化された [screen] を [[size=250]] でクエリーし、US-region フィルター、カテゴリ-aware EquityQuery/ETFQuery の述語、アセット/マーケット-cap の降順を使用します.

StockScreen MCP

A typed FastMCP server for Yahoo Finance-backed technical, fundamental, options, news, custom, and watchlist screening. It supports local stdio and containerized Streamable HTTP transports.

Tools

• run_stock_screen(screen_type, criteria, watchlist=None, save_result=None)
• get_stock_news(symbol, days_back=30)
• manage_watchlist(action, name, symbols=None)
• get_screening_result(name)

Legacy inputs and the five original screen categories are retained. Unknown criteria are rejected rather than silently ignored. Technical screens support the original price, volume, SMA-50/SMA-200, RSI, and ATR criteria. Fundamental screens include minimum/maximum market cap, P/E, dividend, revenue growth, profit margin, debt/equity, price/book, AUM, expense ratio, and volume. Options screens include IV, option volume, put/call ratio, spread, expiration-day, and earnings-day bounds. ETF, news, and nested custom criteria retain their original names. Explicit symbols or a watchlist are preferred. With neither, the server uses yfinance’s documented screen query with size=250, US-region filters, category-aware EquityQuery/ETFQuery predicates, and assets/market-cap descending order. Universe metadata includes source, category, requested/returned size, sort, and as-of time. Missing requested metrics reject a symbol instead of becoming zero, and every rejected symbol retains reasons. Persistence names are restricted and normalized JSON writes are atomic under ~/.stockscreen; no migration runs during import.

uv sync --locked
uv run python stockscreen.py

The server uses stdio and emits no logs or migration messages to stdout. Yahoo Finance is an unofficial personal-use source and may be delayed, incomplete, rate-limited, or structurally changed. Results are not investment advice or guaranteed real-time data.

Docker / Streamable HTTP

The container runs as an unprivileged user, installs the locked production dependencies, and serves MCP at http://127.0.0.1:8000/mcp. Start it with:

docker compose up --build -d
Invoke-RestMethod http://127.0.0.1:8000/health

Connect a Streamable HTTP-capable MCP client to http://127.0.0.1:8000/mcp. The named stockscreen-data volume persists watchlists and saved results across container replacement. To avoid a port collision when running multiple servers, set MCP_HOST_PORT before starting Compose, for example $env:MCP_HOST_PORT=8002. Stop the container with docker compose down; add --volumes only when you intentionally want to delete the persisted data.

The Compose mapping intentionally binds to localhost. The endpoint has no authentication or TLS and must not be exposed to an untrusted network without a properly configured reverse proxy and access control.