StockFlow MCP Server

Ein Model Context Protocol (MCP)-Server, der Echtzeit-Aktiendaten und Optionsanalysen über Yahoo Finance bereitstellt. Ermöglicht LLMs den Zugriff auf Marktdaten, die Analyse von Aktien und die Bewertung von Optionsstrategien.

Funktionen

Aktiendaten

• Echtzeit-Aktienkurse und wichtige Kennzahlen

• Historische Kursdaten mit OHLC-Werten

• Unternehmenskennzahlen und Finanzberichte

• Marktindikatoren und Kennzahlen

Optionsanalyse

• Vollständige Optionskettendaten

• Griechen (Delta, Gamma, Theta, Vega)

• Verfolgung von Volumen und offenem Interesse

• Analyse von Optionsstrategien

Related MCP server: MCP Yahoo Finance

Installation

# Install dependencies
pip install mcp yfinance

# Clone the repository
git clone https://github.com/twolven/stockflow
cd stockflow

Verwendung

1. Klonen Sie das Repository:

git clone https://github.com/twolven/mcp-stockflow.git
cd mcp-stockflow

2. Installieren Sie die Abhängigkeiten:

pip install -r requirements.txt

3. Fügen Sie zu Ihrer Claude-Konfiguration hinzu: Fügen Sie in Ihrer claude-desktop-config.json Folgendes zum Abschnitt mcpServers hinzu:

{
    "mcpServers": {
        "stockflow": {
            "command": "python",
            "args": ["path/to/stockflow.py"]
        }
    }
}

Ersetzen Sie "path/to/stockflow.py" durch den vollständigen Pfad zu der Stelle, an der Sie die Datei stockflow.py gespeichert haben.

Verwendungshinweis für Claude

Wenn Sie mit Claude arbeiten, können Sie diesen Hinweis verwenden, um ihm die verfügbaren Tools zu erklären:

"Ich habe die stockflow-Tools aktiviert, die Ihnen Zugriff auf Aktienmarktdaten geben. Sie können diese drei Hauptfunktionen verwenden:

1. get_stock_data – Umfassende Aktieninformationen abrufen:

{
    "symbol": "AAPL",
    "include_financials": true,  # optional
    "include_analysis": true,    # optional
    "include_calendar": true     # optional
}

2. get_historical_data – Kursverlauf und technische Indikatoren abrufen:

{
    "symbol": "AAPL",
    "period": "1y",        # 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
    "interval": "1d",      # 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo
    "prepost": false       # optional - include pre/post market data
}

3. get_options_chain – Optionsdaten abrufen:

{
    "symbol": "AAPL",
    "expiration_date": "2024-12-20",  # optional - uses nearest date if not specified
    "include_greeks": true            # optional
}

Alle Antworten enthalten aktuelle Kursdaten, Fehlerbehandlung und umfassende Marktinformationen."

Server ausführen

python stockflow.py

Verwendung mit MCP-Client

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

server_params = StdioServerParameters(
    command="python",
    args=["stockflow.py"]
)

async def run():
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            
            # Get current stock data
            result = await session.call_tool(
                "get-stock-data", 
                arguments={"symbol": "AAPL"}
            )
            
            # Get options chain
            options = await session.call_tool(
                "get-options-chain",
                arguments={
                    "symbol": "AAPL",
                    "expiration_date": "2024-12-20"
                }
            )

if __name__ == "__main__":
    import asyncio
    asyncio.run(run())

Verfügbare Tools

1. get-stock-data

   • Aktueller Preis und Volumen

   • Marktkapitalisierung und KGV

   • 52-Wochen-Hoch/Tief

2. get-historical-data

   • OHLC-Kurse

   • Konfigurierbare Zeiträume

   • Volumendaten

3. get-options-chain

   • Calls und Puts

   • Ausübungspreise

   • Griechen und IV

   • Volumen und offenes Interesse

Verfügbare Ressourcen

1. company-info://{symbol}

   • Unternehmensbeschreibung

   • Sektor und Branche

   • Mitarbeiterzahl

   • Website

2. financials://{symbol}

   • Gewinn- und Verlustrechnung

   • Bilanz

   • Kapitalflussrechnung

Prompts

1. analyze-options

   • Analyse von Optionsstrategien

   • Risiko-/Ertragsbewertung

   • Bewertung der Marktbedingungen

Anforderungen

• Python 3.12+

• mcp

• yfinance

Einschränkungen

• Die Daten stammen von Yahoo Finance und können Verzögerungen aufweisen.

• Die Verfügbarkeit von Optionsdaten hängt von den Marktzeiten ab.

• Es gelten Ratenbegrenzungen basierend auf den Einschränkungen der Yahoo-Finance-API.

Mitwirken

Beiträge sind willkommen! Sie können gerne einen Pull Request einreichen.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe die Datei LICENSE für Details.

Autor

Todd Wolven – Leitender KI-Softwareentwickler und Open-Source-GenAI-Ingenieur

Danksagungen

• Erstellt mit dem Model Context Protocol (MCP) von Anthropic

• Daten bereitgestellt von Yahoo Finance

• Entwickelt für die Verwendung mit Claude von Anthropic