Yahoo Finance MCP-Server

👁 PyPI version
👁 Python
👁 CI
👁 License: MIT

Ein Model Context Protocol (MCP)-Server, der KI-Assistenten Zugriff auf Yahoo Finance-Daten über yfinance bietet. Fragen Sie Aktieninformationen, Finanznachrichten, Branchenrankings ab und erstellen Sie professionelle Finanzdiagramme – alles direkt aus Ihrem KI-Chat.

Funktionen

• Aktiendaten — Unternehmensinformationen, Finanzkennzahlen, Bewertungsmetriken, Dividenden und Handelsdaten

• Finanzberichte — Gewinn- und Verlustrechnung sowie Bilanz mit historischen Daten (EBIT, investiertes Kapital usw.)

• Finanznachrichten — Aktuelle Nachrichtenartikel und Pressemitteilungen für jedes Tickersymbol

• Suche — Finden Sie Aktien, ETFs und Nachrichten auf Yahoo Finance

• Branchenrankings — Top-ETFs, Investmentfonds, Unternehmen, Wachstumsführer und Spitzenreiter nach Branche

• Preishistorie — Historische OHLCV-Daten als Markdown-Tabellen oder professionelle Diagramme

• Diagrammerstellung — Candlestick-, VWAP- und Volumenprofil-Diagramme als WebP-Bilder

Related MCP server: MCP Yahoo Finance

Tools

yfinance_get_ticker_info

Ruft umfassende Aktiendaten ab, einschließlich Unternehmensinformationen, Finanzkennzahlen, Handelsmetriken und Governance-Daten.

Rückgabe: JSON-Objekt mit Unternehmensdetails, Preisdaten, Bewertungsmetriken, Handelsinformationen, Dividenden, Finanzkennzahlen und Leistungsindikatoren.

yfinance_get_ticker_news

Ruft aktuelle Nachrichtenartikel und Pressemitteilungen für eine bestimmte Aktie ab.

Rückgabe: JSON-Array von Nachrichtenelementen mit Titel, Zusammenfassung, Veröffentlichungsdatum, Anbieter, URL und Miniaturansicht.

yfinance_search

Durchsucht Yahoo Finance nach Aktien, ETFs und Nachrichtenartikeln.

Rückgabe: Passende Kurse und/oder Nachrichtenergebnisse, abhängig vom search_type.

yfinance_get_top

Ruft die am besten bewerteten Finanzunternehmen innerhalb eines Marktsektors ab.

Rückgabe: JSON-Array der Top-Unternehmen mit relevanten Kennzahlen.

Unterstützte Sektoren

Basic Materials, Communication Services, Consumer Cyclical, Consumer Defensive, Energy, Financial Services, Healthcare, Industrials, Real Estate, Technology, Utilities

yfinance_get_price_history

Ruft historische Preisdaten ab und erstellt optional Diagramme zur technischen Analyse.

Diagrammtypen:

Rückgabe:

• Ohne chart_type: Markdown-Tabelle mit den Spalten Datum, Eröffnung, Hoch, Tief, Schluss, Volumen, Dividenden und Aktiensplits.

• Mit chart_type: Base64-kodiertes WebP-Bild für effiziente Token-Nutzung.

yfinance_get_financials

Ruft Finanzberichte (Gewinn- und Verlustrechnung, Bilanz und Cashflow) mit historischen Daten ab.

Rückgabe: JSON-Objekt mit Gewinn- und Verlustrechnung, Bilanz und Cashflow-Daten für jeden Berichtszeitraum.

• Felder der Gewinn- und Verlustrechnung: EBIT, Nettoeinkommen, Steuerrückstellungen, Ergebnis vor Steuern, Zinsaufwand, Gesamtumsatz, Betriebsergebnis, EBITDA, Normalisiertes Einkommen

• Bilanzfelder: Eigenkapital, Gesamtverschuldung, Barmittel und Barmitteläquivalente, investiertes Kapital, Nettoverschuldung, Gesamtvermögen, Gesamtverbindlichkeiten abzüglich Minderheitenanteile, materielle Nettovermögenswerte, materieller Buchwert

• Cashflow-Felder: Operativer Cashflow, freier Cashflow, Investitionsausgaben, Nettoeinkommen aus fortgeführten Aktivitäten, Abschreibungen und Amortisationen, Veränderung des Betriebskapitals, gezahlte Bardividenden

Verwendung

Via uv (empfohlen)

1. Installieren Sie uv

2. Fügen Sie Folgendes zu Ihrer MCP-Client-Konfiguration hinzu:

{
 "mcpServers": {
 "yfmcp": {
 "command": "uvx",
 "args": ["yfmcp@latest"]
 }
 }
}

Via Docker

{
 "mcpServers": {
 "yfmcp": {
 "command": "docker",
 "args": ["run", "-i", "--rm", "narumi/yfinance-mcp"]
 }
 }
}

Aus dem Quellcode

1. Klonen Sie das Repository und installieren Sie die Abhängigkeiten:

git clone https://github.com/narumiruna/yfinance-mcp.git
cd yfinance-mcp
uv sync

2. Fügen Sie Folgendes zu Ihrer MCP-Client-Konfiguration hinzu:

{
 "mcpServers": {
 "yfmcp": {
 "command": "uv",
 "args": [
 "run",
 "--directory",
 "/path/to/yfinance-mcp",
 "yfmcp"
 ]
 }
 }
}

Ersetzen Sie /path/to/yfinance-mcp durch den tatsächlichen Pfad zu Ihrem geklonten Repository.

Entwicklung

Voraussetzungen

• Python ≥ 3.12

• uv Paketmanager

Einrichtung

uv sync --extra dev

Lint & Format

uv run ruff check .
uv run ruff format .

Typenprüfung

uv run ty check src tests

Test

uv run pytest -v -s --cov=src tests

Demo-Chatbot

Sehen Sie sich den Demo-Chatbot in seinem dedizierten Repository an: yfinance-mcp-demo

Mitwirkende

Erstellt mit contrib.rocks.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• yfinance_get_financialsA
• yfinance_get_holdersA
• yfinance_get_option_chainA
• yfinance_get_option_datesA
• yfinance_get_price_historyA
• yfinance_get_ticker_infoA
• yfinance_get_ticker_newsA
• yfinance_get_topA