/ Verzeichnis / Playground / YFinance MCP
● Community narumiruna ⚡ Sofort

YFinance MCP

von narumiruna · narumiruna/yfinance-mcp

Yahoo Finance via MCP — Kurse, Fundamentaldaten, historische OHLC-Daten, Optionsketten und News für beliebige Ticker, kostenlos.

Kapselt das yfinance-Python-Paket als MCP. Kein API-Key erforderlich. Gut geeignet für das Prototyping von Finanz-Agents, Backtesting-Ideen oder die Anreicherung von Recherche-Prompts mit echten Marktdaten. Daten sind verzögert und rate-limitiert — nicht für den Produktionseinsatz im Trading.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

yfinance-mcp.replay ▶ bereit
0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "yfinance-mcp",
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "yfinance-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "yfinance-mcp"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add yfinance-mcp -- uvx yfinance-mcp

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: YFinance MCP

Schneller Überblick über deine Watchlist — Kurse, KGV, News

👤 Anleger beim täglichen Check-in ⏱ ~5 min beginner

Wann einsetzen: Du willst ein Ein-Prompt-Briefing zu 10 Tickern vor Marktöffnung.

Ablauf
  1. Kurse
    Nutze yfinance-mcp. Für AAPL, MSFT, NVDA, TSLA, GOOGL, AMZN, META, BRK-B, JPM, V — aktueller Kurs, 1T %, 52-Wochen-Spanne.✓ Kopiert
    → Saubere Tabelle mit allen 10 Zeilen
  2. Fundamentaldaten
    Für dieselbe Liste: KGV, Forward-KGV, EPS und Dividendenrendite.✓ Kopiert
    → Fundamentaldaten passend zur vorherigen Tabelle
  3. News
    Für die 3 größten Bewegungen heute: die 3 aktuellsten Schlagzeilen abrufen. Stimmung zusammenfassen.✓ Kopiert
    → News nach Ticker gruppiert mit 1-Zeilen-Stimmungsbeschreibung

Ergebnis: Ein 10-Zeilen-Morgenbriefing, zugeschnitten auf deine Watchlist.

Fallstricke
  • Rate-Limit bei zu vielen Tickern auf einmal — In 10er-Blöcken aufteilen, 1 Sekunde Pause dazwischen
Kombinieren mit: memory

Eine einfache Strategieidee auf historischen Kursen backtesten

👤 Retail-Trader beim Prototyping ⏱ ~20 min intermediate

Wann einsetzen: Du hast eine Idee wie „SPY kaufen wenn RSI < 30, verkaufen bei > 70“ und willst einen schnellen historischen Plausibilitätscheck.

Ablauf
  1. Historische Daten abrufen
    5-Jahres-Tagesdaten OHLC für SPY abrufen.✓ Kopiert
    → Zeitreihe als Array zurückgegeben
  2. Berechnen
    RSI(14) berechnen. Strategie „Kauf<30, Verkauf>70“ ausführen. CAGR, maximaler Drawdown, Anzahl Trades vs. Buy-and-Hold berichten.✓ Kopiert
    → Strategie-Kennzahlen mit ehrlichem Vergleich zur Benchmark
  3. Realitätscheck
    Provisionen ($1/Trade) und Slippage (5 Basispunkte) einrechnen. Überlebt der Edge das?✓ Kopiert
    → Zahlen nach Kosten

Ergebnis: Eine Ja/Nein-Entscheidung, ob die Idee weiter getestet werden soll.

Fallstricke
  • Survivorship Bias — nur liquide Ticker sind in yfinance — Für ernstes Backtesting ein dediziertes Dataset verwenden; yfinance ist zum Skizzieren
Kombinieren mit: alpaca

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

yfinance-mcp + alpaca

yfinance für Recherche, Alpaca für tatsächliche Orders

3 Ideen via yfinance auswählen, Paper Trades via Alpaca platzieren.✓ Kopiert
yfinance-mcp + memory

Eigene Ticker-Thesen über Zeit verfolgen

Die NVDA-These von heute zusammen mit dem aktuellen Kurs in memory speichern.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
get_quote ticker: str Aktueller Kurs-Snapshot free
get_history ticker, period: str, interval: str Historische Daten für Charts oder Backtests free
get_fundamentals ticker Bewertungs- / Fundamentalanalyse free
get_options ticker, expiry?: date Optionsketten-Abfrage free
get_news ticker, limit?: int Schlagzeilen auf Ticker-Ebene free

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
Yahoos undokumentierte Limits — nicht zu intensiv anfragen
Tokens pro Aufruf
OHLC für 5 Jahre ≈ 50k Token; Anfragen gezielt halten
Kosten in €
Kostenlos
Tipp
Für längere Historien auf Wochenbasis resamplen; Tagesdaten nur wenn nötig

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: Keine
Datenabfluss: query1.finance.yahoo.com

Fehlerbehebung

Häufige Fehler und Lösungen

Gibt leere Antwort / Fehler für einen Ticker zurück

Yahoo-Format-Symbole verwenden (z. B. BRK-B statt BRK.B); einige Börsen brauchen Suffix (.T für Tokio)

JSONDecodeError

Yahoo hat dich rate-limitiert. Einige Minuten warten oder weniger Ticker pro Batch.

Paket veraltet

uvx --upgrade yfinance-mcp — Yahoo bricht Dinge regelmäßig

Alternativen

YFinance MCP vs. andere

AlternativeWann stattdessenKompromiss
Alpaca MCPDu willst echte Broker-Daten + OrderausführungAlpaca-Konto erforderlich
Polygon / FinnhubDu brauchst produktionsreife, niedriglatente DatenKostenpflichtig; noch kein MCP

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen