MMCPMarkets
BM

bxxd/mcp-yfinance-ux

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

6 stars 3 forks Качество 59 Тренд 22
Repository Install

Market data for AI agents. Bloomberg Terminal-style screens with formatted output. Not raw JSON - dense, scannable tables ready to interpret. Smart defaults, progressive disclosure.

Обзор

Market data in Bloomberg Terminal format. Not raw JSON - I give you formatted tables you can read directly. Navigate like BBG: markets() → sector('technology') → ticker('AAPL') → ticker_options('AAPL'). Smart defaults (auto-detects market hours), progressive disclosure (summary → detail). Dense, scannable screens. Factor exposures, momentum, options positioning - all formatted like a professional terminal. Local stdio server, powered by yfinance. All queries user-initiated (no automation - this is a research tool, not production infrastructure). Dense, scannable, professional. Not raw JSON - formatted for humans, AI benefits automatically.

README

Показан фрагмент оригинального README. Открыть оригинал.

mcp-yfinance-ux

For AI agents: Market data in Bloomberg Terminal format. Not raw JSON - I give you formatted tables you can read directly. Navigate like BBG: markets() → sector('technology') → ticker('AAPL') → ticker_options('AAPL'). Smart defaults (auto-detects market hours), progressive disclosure (summary → detail).

For humans: Dense, scannable screens. Factor exposures, momentum, options positioning - all formatted like a professional terminal.

Technical: Local stdio server, powered by yfinance. All queries user-initiated (no automation - this is a research tool, not production infrastructure).

Example Output

Our differentiator: BBG Lite formatted, agent-friendly screens

MARKETS | Sun 2025-10-26 12:42 EDT

US EQUITIES                   PRICE     CHANGE       1M         1Y
S&P 500                      6791.69    +0.79%     +2.2%     +16.9%
Nasdaq                      23204.87    +1.15%     +3.2%     +25.3%
Dow                         47207.12    +1.01%     +2.1%     +12.1%
Russell 2000                 2513.47    +1.24%     +3.3%     +13.8%

SECTORS          TICKER      PRICE     CHANGE       1M         1Y
Technology       XLK          293.58    +1.23%     +5.3%     +28.3%
Financials       XLF           53.11    +0.84%     -1.4%     +15.6%
Healthcare       XLV          146.03    -0.05%     +7.8%      +0.0%
Energy           XLE           88.07    -1.01%     -4.3%      +1.4%
[... all 11 GICS sectors]

COMMODITIES                   PRICE     CHANGE       1M         1Y
Gold                         4137.80    +0.05%     +9.6%     +51.0%
Oil WTI                        61.50    +0.10%     -6.4%     -14.3%

Data as of 2025-10-26 12:42 EDT | Source: yfinance

Dense, scannable, professional. Not raw JSON - formatted for humans, AI benefits automatically.

Features

Bloomberg Terminal-style navigation screens for market data:

  • markets() - Complete factor landscape (US equities, global, sectors, styles, commodities, volatility)
  • sector(name) - Sector drill-down with top holdings and factor exposures
  • ticker(symbol) - Individual security analysis with full factor decomposition
  • Batch comparison - Side-by-side stock analysis with key factors
  • Calendar integration - Earnings dates, dividend schedules
  • BBG Lite formatting - Dense, scannable, professional output

Library Architecture

mcp-yfinance-ux includes a reusable library for reliable yfinance data fetching.

lib/yfinance_fetcher.py

ONE SOURCE OF TRUTH for yfinance fetching logic:

  • Individual yf.Ticker().history() calls with ThreadPoolExecutor (RELIABLE)
  • NOT yf.download() batch API (UNRELIABLE - timeouts, fails entire batch)

Used by:

  1. MCP server - mcp_yfinance_ux/historical.py imports from lib/
  2. Portfolio scripts - Can be copied to portfolio agents for reliable fetching
  3. Any Python code - Pure logic, no MCP dependencies

Key functions:

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "projects": { "/path/to/your/project": { "mcpServers": { "idio-yf": { "type": "stdio", "command": "make", "args": ["-C", "/absolute/path/to/mcp-yfinance-ux", "serve"], "env": {} } } } } }