📈 Servidor MCP de Acciones

Este es un servidor del Protocolo de Contexto de Modelo (MCP) que proporciona análisis técnico y cribado basado en estrategias para acciones de Corea y EE. UU. Puede realizar análisis de gráficos y cribado de acciones mediante lenguaje natural en clientes compatibles con MCP como Claude Desktop y Claude Code.

✨ Características

• 🇰🇷 Análisis de acciones coreanas — OHLCV + indicadores técnicos para todas las acciones de KOSPI/KOSDAQ basado en pykrx

• 🇺🇸 Análisis de acciones estadounidenses — Acciones de NYSE/NASDAQ + capitalización de mercado/PER/máximos y mínimos de 52 semanas basado en yfinance

• 🔍 Búsqueda de acciones — Encontrar códigos de acciones por nombre (acciones coreanas)

• 📊 10 estrategias de Momentum + 7 estrategias de Breakout — Desde cruces dorados hasta VCP

• 🎯 Dos filosofías de cribado — 🐎 Atrapar caballos en carrera vs 🌱 Encontrar caballos que pronto correrán

• 🔎 Prefiltros multietapa — Aumento de volumen, Trend Template, RS, bandas de 52 semanas, etc.

Related MCP server: KIS MCP Server

🛠️ Herramientas

🎯 Cribado: Dos filosofías

🐎 Momentum — Atrapar caballos en carrera

Captura la continuación de la tendencia (Etapa 2) de acciones que ya han entrado en una tendencia alcista. Basado en las teorías CANSLIM de O'Neil y Trend Template de Minervini.

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 전략 적용

Estrategias aplicadas (10)

• 4 existentes: Cruce dorado + volumen, compra en retroceso, ruptura de momentum, explosión de volumen

• 6 nuevas: Divergencia RSI, divergencia MACD, estocástico, BB Squeeze, ruptura de Ichimoku, alineación de 3 medias móviles

🌱 Breakout — Encontrar caballos que pronto correrán

Captura acciones en fase de acumulación / justo antes de la ruptura que aún no se han movido significativamente. Basado en el patrón VCP de Mark Minervini y la teoría de acumulación de Wyckoff.

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)

Estrategias aplicadas (7)

• 4 reutilizadas: Compra en retroceso, explosión de volumen, divergencia MACD, BB Squeeze

• 3 nuevas: Contracción de volatilidad VCP, acumulación silenciosa, transición al final de la Etapa 1

🧪 Comparación de los dos modos

Ejemplo de comparación de resultados reales

Basado en el mismo mercado (KOSPI):

• Momentum: Perspect (cumple 6 estrategias) — Acción que ya está corriendo

• Breakout: Daewon Cable -20.32% en 30 días, retroceso + VCP en el 72% del máximo de 52 semanas — Típico de acumulación

📊 Explicación de la nueva estrategia Breakout

VCP (Volatility Contraction Pattern)

Divide los últimos 15 días en 3 segmentos de 5 días y determina si el rango de máximo-mínimo (%) se contrae secuencialmente. Forma de resorte de bobinado → Ruptura inminente. (Mark Minervini)

Acumulación silenciosa (Silent Accumulation)

El promedio de volumen de los últimos 20 días aumenta en comparación con los 20 días anteriores y hay días de aumento repentino, pero el rango de variación de precio en los mismos 20 días es dentro de ±8% → Acumulación de manos fuertes no revelada al mercado.

Transición al final de la Etapa 1

Segmento que pasa de un rango lateral de suelo (Etapa 1) a un ascenso suave (inicio de Etapa 2).

• Pendiente de MA60 superior a la de hace 1 mes

• MA20 > MA60 (transición alcista a corto plazo)

• Precio de cierre > MA60 (soporte asegurado)

• Ancho de BB ≤ promedio de 20 días (volatilidad aún no expandida)

🔎 Hoja de trucos de parámetros de prefiltro

Común para el cribador de Momentum

Común para el cribador de Breakout

📦 Instalación

Requisitos previos

• Python 3.13+

• uv (recomendado)

Configuración

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

🚀 Uso

Integración con Claude Desktop

Agregue lo siguiente a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Ejecución directa

uv run python server.py

💬 Ejemplos de conversación

Análisis de acciones individuales

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

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

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

Cribado (caballos en carrera)

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

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

Cribado (caballos que pronto correrán)

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

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

Diagnóstico de estrategia de acción individual

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

📋 Ejemplos de salida

Resultados de cribado de Momentum (resumen)

{
  "스크리닝일": "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
    }
  ]
}

Resultados de cribado de Breakout (resumen)

{
  "스크리닝일": "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 — Framework de servidor MCP

• pykrx — Datos de la Bolsa de Corea

• yfinance — Datos de Yahoo Finance

• ta — Indicadores de análisis técnico

• BeautifulSoup + lxml — Parsing HTML de Naver Finance / Yahoo Screener

• pandas — Procesamiento de datos

📚 Referencias

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

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

• Richard Wyckoff — Teoría de acumulación/distribución de precio-volumen

• Stan Weinstein — Secrets for Profiting in Bull and Bear Markets (Análisis de Etapas)

📄 Licencia

MIT