Yfinance를 통해 주식 메타데이터, 가격 역사, 기술 지표, 금융 문, 달력 및 옵션 체인에 대한 Typed FastMCP 서버. 로컬 stdio와 containerized Streamable HTTP 전송을 지원합니다.

도구

• [T0]]
• get_historical_data_v2(symbol, period, interval='1d', prepost=False)
• [T2]]

Historical downloads 명시적으로 사용 unadjusted 가격, 수리 활성화, timezone 유지, timeout, 및 플랫 단일 증상 인덱스. Rows는 타임스탬프를 유지하고 별도의 조정 닫힌 열을 omit. 변동성은 요청한 간격을 위해 연산되며, 252/5은 5일 막대를 사용하며, 장시간 세션을 위한 인트라데이 기간을 확장합니다. RSI는 정의된 Zero-gain/loss 행동과 더불어 반복적인 매끄럽게 하기에 따라 canonical Wilder 간단한 평균씨를 이용합니다. 요청할 때, 옵션 그리스는 이론적 인 유럽 블랙 쵸스 (일당) 추정치입니다. (1 퍼센트 포인트 당 vega/rho); 위험이없는 메타 데이터는 구성 된 미들백을 식별합니다.

서버는 stdio를 사용합니다.

StockFlow MCP

A typed FastMCP server for stock metadata, price history, technical indicators, financial statements, calendars, and option chains through yfinance. It supports local stdio and containerized Streamable HTTP transports.

Tools

• get_stock_data_v2(symbol, include_financials=False, include_analysis=False, include_calendar=False)
• get_historical_data_v2(symbol, period, interval='1d', prepost=False)
• get_options_chain_v2(symbol, expiration_date=None, include_greeks=False)

Historical downloads explicitly use unadjusted prices, repair enabled, timezone retention, a timeout, and a flat single-symbol index. Rows retain timestamps and omit the separately adjusted-close column. Volatility is annualized for every requested interval, uses 252/5 for five-day bars, and scales intraday periods for extended-hours sessions. RSI uses the canonical Wilder simple-average seed followed by recursive smoothing, with defined zero-gain/loss behavior. When requested, option Greeks are theoretical European Black-Scholes estimates per share (theta per day; vega/rho per one percentage point); risk-free-rate metadata identifies the configured fallback.

uv sync --locked
uv run python stockflow.py

The server uses stdio. Yahoo Finance is an unofficial personal-use source and may be delayed, incomplete, rate-limited, missing fields, or structurally changed. Dividends and American-style early exercise are not modeled in Greeks. 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. To avoid a port collision when running multiple servers, set MCP_HOST_PORT before starting Compose, for example $env:MCP_HOST_PORT=8003. Stop and remove the container with docker compose down.

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.

Binding to loopback alone does not make the endpoint private: a browser can still reach it through DNS rebinding, so the server validates Host and Origin headers before a request reaches an MCP session. Requests carrying a foreign Host are answered with 421 Misdirected Request and those carrying a foreign Origin with 403 Forbidden, while same-origin loopback traffic and non-browser clients that send no Origin are unaffected.