fintools-mcp

Finanzanalysetools für KI-Assistenten via MCP (Model Context Protocol).

Ermöglichen Sie Claude, ChatGPT, Cursor oder jeder anderen MCP-kompatiblen KI den Zugriff auf echte Finanzanalysen – nicht nur Aktienkurse, sondern das analytische Toolkit, das ein Trader tatsächlich verwendet.

Tools

Tool	Was es tut
`get_technical_indicators`	RSI, MACD, ATR, EMAs (9/21/50/200), Fibonacci-Level, Trendbewertung
`get_stock_quote`	Aktueller Kurs, Volumen, 52-Wochen-Spanne, Marktkapitalisierung
`get_trend_score`	Trend-Score von -100 (starker Abwärtstrend) bis +100 (starker Aufwärtstrend) mit Komponentenaufschlüsselung
`get_support_resistance`	Wichtige Unterstützungs-/Widerstandsniveaus mit Berührungshäufigkeit und Stärkebewertung
`screen_stocks`	S&P 500 nach RSI, Trend-Score, EMA-Position, relativem Volumen screenen — Setups schnell finden
`analyze_options_chain`	Optionskette mit IV-Analyse, Liquiditätsfilterung, Put/Call-Verhältnissen
`calculate_position_size`	Risikobasierte Positionsgrößenbestimmung mit Stop-Loss und Gewinnziel
`calculate_atr_position`	ATR-basierte Positionsgrößenbestimmung — berechnet Stop und Ziel automatisch basierend auf Volatilität
`analyze_trades`	Gewinnrate, Profitfaktor, Sharpe-Ratio, Drawdown, Serien aus Handels-P&Ls
`compare_tickers`	Technischer Vergleich mehrerer Symbole nebeneinander

Funktionsweise

fintools-mcp Sequenzdiagramm

Schnellstart

Installation

pip install fintools-mcp

Oder mit uv:

uv pip install fintools-mcp

Zu Claude Desktop hinzufügen

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "fintools": {
      "command": "uv",
      "args": ["run", "--from", "fintools-mcp", "fintools-mcp"]
    }
  }
}

Oder falls via pip installiert:

{
  "mcpServers": {
    "fintools": {
      "command": "fintools-mcp"
    }
  }
}

Zu Claude Code hinzufügen

claude mcp add fintools -- uv run --from fintools-mcp fintools-mcp

Beispiele

Sobald die Konfiguration abgeschlossen ist, können Sie Ihren KI-Assistenten Dinge fragen wie:

"Finde überverkaufte S&P 500-Aktien, die noch über ihrem 200er EMA liegen"
"Wie ist der Trend-Score von SPY?"
"Zeige mir die Unterstützungs- und Widerstandsniveaus für NVDA"
"Wie sieht das technische Setup für AAPL aktuell aus?"
"Analysiere die SPY-Optionskette für nächsten Freitag"
"Wenn ich mit einem 100.000-Dollar-Konto NVDA long gehen möchte und 1,5 % riskiere, wie viele Aktien soll ich kaufen und wo liegt mein Stop?"
"Vergleiche AAPL, GOOGL, MSFT und AMZN — welche Aktie hat den stärksten Trend?"
"Hier sind meine letzten 20 Trades: [150, -80, 200, ...] — wie hoch sind meine Gewinnrate und Sharpe-Ratio?"

Beispielausgabe

Technische Indikatoren

> "What's the technical setup on SPY?"

SPY @ $573.42
  RSI(14): 58.3 — bullish momentum
  MACD: 2.14 (histogram +0.38, bullish)
  ATR(14): $7.82
  EMAs: 9 > 21 > 50 > 200 (fully stacked bullish)
  Fibonacci: In golden pocket (0.618-0.65 retracement)
  Trend: Bullish (all signals aligned)

Positionsgrößenbestimmung

> "Size a long position on AAPL at $227, stop $220, target $245"

  Shares: 214
  Position value: $48,578
  Risk: $1,498 (1.5% of $100k)
  Reward: $3,852
  R:R ratio: 2.57

Architektur

fintools-mcp/
├── fintools_mcp/
│   ├── server.py              # MCP server — tool definitions
│   ├── data.py                # Market data via yfinance
│   ├── indicators/            # Technical indicators (standalone, no deps)
│   │   ├── rsi.py             # RSI — Wilder's smoothing
│   │   ├── macd.py            # MACD (12, 26, 9)
│   │   ├── atr.py             # ATR — Average True Range
│   │   ├── ema.py             # EMA — any period
│   │   ├── vwap.py            # VWAP — intraday, daily reset
│   │   └── fibonacci.py       # Fibonacci retracement + golden pocket
│   └── analysis/
│       ├── position_sizer.py  # Risk-based + ATR-based sizing
│       └── trade_stats.py     # KPI calculator (60+ metrics)
└── tests/

Datenquellen

Aktienkurse: Yahoo Finance (kostenlos, kein API-Schlüssel erforderlich)
Optionsdaten: Yahoo Finance Optionsketten
Für die Basisfunktionalität sind keine API-Schlüssel erforderlich.

Entwicklung

git clone https://github.com/slimbiggins007/fintools-mcp.git
cd fintools-mcp
uv sync
uv run python -m fintools_mcp  # starts the MCP server

Tests ausführen:

uv run pytest

Lizenz

MIT

fintools-mcp

fintools-mcp

Tools

Funktionsweise

Schnellstart

Installation

Zu Claude Desktop hinzufügen

Zu Claude Code hinzufügen

Beispiele

Beispielausgabe

Technische Indikatoren

Positionsgrößenbestimmung

Architektur

Datenquellen

Entwicklung

Lizenz

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API