📈 Stock MCP Server

Dies ist ein Model Context Protocol (MCP) Server, der technische Analysen und strategiebasierte Screenings für koreanische und US-amerikanische Aktien bereitstellt. Sie können Chartanalysen und Aktienscreenings in natürlicher Sprache in MCP-kompatiblen Clients wie Claude Desktop oder Claude Code durchführen.

✨ Funktionen

• 🇰🇷 Analyse koreanischer Aktien — OHLCV + technische Indikatoren für alle KOSPI/KOSDAQ-Aktien basierend auf pykrx

• 🇺🇸 Analyse US-amerikanischer Aktien — NYSE/NASDAQ-Aktien + Marktkapitalisierung/KGV/52-Wochen-Hoch/Tief basierend auf yfinance

• 🔍 Aktiensuche — Suche nach Aktiencodes anhand des Namens (für koreanische Aktien)

• 📊 10 Momentum-Strategien + 7 Breakout-Strategien — Von Golden Cross bis VCP

• 🎯 Zwei Screening-Philosophien — 🐎 Auf den fahrenden Zug aufspringen vs. 🌱 Aktien finden, die bald starten

• 🔎 Mehrstufige Vorfilter — Volumenanstiege, Trend Template, RS, 52-Wochen-Bänder usw.

Related MCP server: KIS MCP Server

🛠️ Tools

🎯 Screening: Zwei Philosophien

🐎 Momentum — Auf den fahrenden Zug aufspringen

Erfasst die Trendfortsetzung (Stage 2 continuation) von Aktien, die sich bereits in einem Aufwärtstrend befinden. Basierend auf O'Neils CANSLIM und Minervinis Trend Template Theorie.

Pipeline

시드 (네이버 거래량/상승률/급등  |  Yahoo most_actives/day_gainers/small_cap_gainers)
  ↓
① min_trade_value         — 유동성
② 당일 과열 제외 +10% 이상  — 추격매수 방지
③ 20일 내 거래량 급증 ≥ 3x  — 자금 유입 시그널
④ Minervini Trend Template — Stage 2 6조건 (ON)
⑤ 52주 고점 근접            — OFF (Trend Template과 중복)
⑥ RS vs 지수               — OFF (opt-in, 강한 종목만 보고 싶을 때)
  ↓
10가지 Momentum 전략 적용

Angewandte Strategien (10)

• Bestehend (4): Golden Cross + Volumen, Pullback-Kauf, Momentum-Ausbruch, Volumenexplosion

• Neu (6): RSI-Divergenz, MACD-Divergenz, Stochastik, BB-Squeeze, Ichimoku-Ausbruch, 3-Linien-Aufwärtstrend

🌱 Breakout — Aktien finden, die bald starten

Erfasst Aktien, die sich noch in der Akkumulationsphase / kurz vor dem Ausbruch befinden. Basierend auf Mark Minervinis VCP-Muster und Wyckoffs Akkumulationstheorie.

Pipeline

시드 (Momentum과 동일 — 매집도 거래량에 반영됨)
  ↓
① min_trade_value
② 당일 과열 제외 +10% 이상
③ 누적 상승 한도: 최근 30일 +30% 이상 제외   ← Breakout 전용
④ 52주 밴드: 고점 × 0.85 이하 AND 저점 × 1.20 이상 ← 전용 (중간권만)
⑤ 20일 내 거래량 급증 ≥ 2x                    (momentum의 3x보다 완화)
  ↓
Breakout 7전략 적용  (Trend Template / 52w 근접 / RS 모두 off)

Angewandte Strategien (7)

• Wiederverwendet (4): Pullback-Kauf, Volumenexplosion, MACD-Divergenz, BB-Squeeze

• Neu (3): VCP Volatilitätskontraktion, Stille Akkumulation, Übergang spätes Stage 1

🧪 Vergleich der beiden Modi

Beispiel für Praxisergebnisse

Basierend auf demselben Markt (KOSPI):

• Momentum: Perspect (erfüllt 6 Strategien) — Eine Aktie, die bereits läuft

• Breakout: Daewon Cable 30 Tage -20,32%, Pullback+VCP bei 72% des 52-Wochen-Hochs — Typische Akkumulation

📊 Erklärung der neuen Breakout-Strategien

VCP (Volatility Contraction Pattern)

Die letzten 15 Tage werden in drei 5-Tage-Abschnitte unterteilt, um zu prüfen, ob sich die Hoch-Tief-Spanne (%) sukzessive verringert. Coiling-Spring-Form → Ausbruch steht bevor. (Mark Minervini)

Stille Akkumulation (Silent Accumulation)

Das durchschnittliche Volumen der letzten 20 Tage ist im Vergleich zu den vorherigen 20 Tagen gestiegen und es gibt Tage mit Volumenanstiegen, aber die Preisspanne innerhalb derselben 20 Tage liegt innerhalb von ±8% → Akkumulation durch institutionelle Anleger, die nicht sofort sichtbar ist.

Übergang spätes Stage 1

Der Bereich, in dem der Übergang von der Bodenbildungsphase (Stage 1) zum moderaten Anstieg (Beginn Stage 2) erfolgt.

• MA60-Steigung höher als vor einem Monat

• MA20 > MA60 (kurzfristiger Aufwärtstrend)

• Schlusskurs > MA60 (Unterstützung gesichert)

• BB-Breite ≤ 20-Tage-Durchschnitt (Volatilität noch nicht ausgeweitet)

🔎 Cheat Sheet für Vorfilter-Parameter

Momentum-Screener allgemein

Breakout-Screener allgemein

📦 Installation

Voraussetzungen

• Python 3.13+

• uv (empfohlen)

Einrichtung

git clone https://github.com/Juuuuuuni/stock-mcp-server.git
cd stock-mcp-server
uv sync

🚀 Verwendung

Integration in Claude Desktop

Fügen Sie Folgendes zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzu:

{
  "mcpServers": {
    "stock-analyzer": {
      "command": "uv",
      "args": [
        "--directory",
        "/절대/경로/stock-mcp-server",
        "run",
        "python",
        "server.py"
      ]
    }
  }
}

Direkte Ausführung

uv run python server.py

💬 Konversationsbeispiele

Analyse einzelner Aktien

👤 삼성전자 최근 분석해줘
🤖 [get_stock_analysis("005930")] → 현재가 / RSI / MACD / 추세 해석

👤 NVDA 한 달 차트 분석
🤖 [get_us_stock_analysis("NVDA", days=30)]

👤 알체라 종목코드가 뭐야?
🤖 [search_stock("알체라")] → 347860

Screening (Fahrende Züge)

👤 지금 코스피에서 뜨는 종목 찾아줘
🤖 [screen_kr_momentum(market="KOSPI")]
   → Stage 2 추세 + 거래량 급증 종목. 퍼스텍(6전략), 대우건설(3전략) …

👤 미국 주식에서 강세 종목만 (RS 10pp 이상)
🤖 [screen_us_momentum(enable_rs_filter=True, min_rs_outperformance=10.0)]

Screening (Bald startende Aktien)

👤 코스닥에서 매집 단계 종목 스크리닝
🤖 [screen_kr_breakout(market="KOSDAQ")]
   → 누적 상승 30% 미만 + 52주 중간권 + VCP/매집 패턴

👤 아직 안 오른 바닥 종목만 (최근 30일 +10% 이내)
🤖 [screen_kr_breakout(max_cumulative_return_pct=10.0)]

Strategiediagnose für einzelne Aktien

👤 알체라 지금 어떤 단계야?
🤖 [diagnose_stock(ticker="347860", market="KR")]
   → 10전략 중 어느 조건 통과했는지 상세 진단

📋 Ausgabebeispiele

Momentum-Screening-Ergebnisse (Zusammenfassung)

{
  "스크리닝일": "20260413",
  "대상시장": "KOSPI",
  "시드후보수": 80,
  "필터링_단계별_통과": {
    "당일과열제외": 64,
    "거래량급증": 31,
    "Trend_Template": 8,
    "52주고점근접": 0,
    "RS": 0
  },
  "필터링결과수": 26,
  "결과": [
    {
      "종목코드": "010820",
      "종목명": "퍼스텍",
      "전략": "모멘텀 돌파",
      "점수": "5/5",
      "현재가": 2340,
      "등락률": "+4.23%",
      "RSI": 68.4,
      "거래량비": "2.1x",
      "20일내_최대거래량배율": "8.7x",
      "복수전략": true
    }
  ]
}

Breakout-Screening-Ergebnisse (Zusammenfassung)

{
  "스크리닝일": "20260413",
  "모드": "Breakout (곧 달릴 말)",
  "대상시장": "KOSPI",
  "시드후보수": 80,
  "필터링_단계별_통과": {
    "당일과열제외": 64,
    "누적상승한도": 55,
    "52주밴드": 22,
    "거래량급증": 12
  },
  "필터링결과수": 28,
  "결과": [
    {
      "종목코드": "006340",
      "종목명": "대원전선",
      "전략": "눌림목 매수",
      "점수": "5/5",
      "현재가": 1245,
      "30일누적": "-20.32%",
      "52주고점대비": "72.2%",
      "52주저점대비": "128.4%",
      "복수전략": true
    }
  ]
}

🧩 Tech Stack

• FastMCP — MCP-Server-Framework

• pykrx — Daten der Korea Exchange

• yfinance — Yahoo Finance-Daten

• ta — Technische Analyseindikatoren

• BeautifulSoup + lxml — HTML-Parsing für Naver Finance / Yahoo Screener

• pandas — Datenverarbeitung

📚 Referenzen

• William J. O'Neil — How to Make Money in Stocks (CANSLIM)

• Mark Minervini — Trade Like a Stock Market Wizard (Trend Template, VCP)

• Richard Wyckoff — Preis-Volumen-Akkumulations-/Distributions-Theorie

• Stan Weinstein — Secrets for Profiting in Bull and Bear Markets (Stage Analysis)

📄 Lizenz

MIT