📈 Stock MCP Server

Это сервер Model Context Protocol (MCP), предоставляющий технический анализ и скрининг стратегий для акций Кореи и США. Вы можете выполнять анализ графиков и скрининг акций на естественном языке в MCP-совместимых клиентах, таких как Claude Desktop и Claude Code.

✨ Функции

• 🇰🇷 Анализ корейских акций — OHLCV + технические индикаторы по всем акциям KOSPI/KOSDAQ на базе pykrx

• 🇺🇸 Анализ американских акций — акции NYSE/NASDAQ + рыночная капитализация/PER/52-недельные максимумы и минимумы на базе yfinance

• 🔍 Поиск акций — поиск кода акции по названию (корейские акции)

• 📊 10 стратегий Momentum + 7 стратегий Breakout — от «золотого креста» до VCP

• 🎯 Две философии скрининга — 🐎 оседлать скачущую лошадь vs 🌱 найти ту, что скоро побежит

• 🔎 Многоуровневые предварительные фильтры — всплески объема, Trend Template, RS, 52-недельные диапазоны и т.д.

Related MCP server: KIS MCP Server

🛠️ Инструменты

🎯 Скрининг: две философии

🐎 Momentum — оседлать скачущую лошадь

Выявляет продолжение тренда (Stage 2 continuation) для акций, которые уже вошли в восходящий тренд. Основано на теориях CANSLIM Уильяма О'Нила и Trend Template Марка Минервини.

Конвейер

시드 (네이버 거래량/상승률/급등  |  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 전략 적용

Применяемые стратегии (10)

• Существующие 4: Золотой крест + объем, покупка на откате, пробой моментума, всплеск объема

• Новые 6: Дивергенция RSI, дивергенция MACD, стохастик, сжатие BB, пробой облака Ишимоку, выравнивание 3 линий

🌱 Breakout — найти ту, что скоро побежит

Выявляет акции, которые еще не совершили значительного движения — стадия накопления / перед пробоем. Основано на паттерне VCP Марка Минервини и теории накопления Вайкоффа.

Конвейер

시드 (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)

Применяемые стратегии (7)

• Повторное использование 4: Покупка на откате, всплеск объема, дивергенция MACD, сжатие BB

• Новые 3: VCP (сжатие волатильности), тихое накопление, переход в конце Stage 1

🧪 Сравнение двух режимов

Пример сравнения практических результатов

На базе одного рынка (KOSPI):

• Momentum: Perseus (соответствует 6 стратегиям) — акция, которая уже скачет

• Breakout: Daewon Cable, 30 дней -20.32%, откат + VCP на уровне 72% от 52-недельного максимума — типичное накопление

📊 Описание новых стратегий Breakout

VCP (Volatility Contraction Pattern)

Последние 15 дней делятся на 3 отрезка по 5 дней, оценивается, последовательно ли сокращается диапазон максимумов-минимумов (%). Форма сжимающейся пружины → скорый пробой. (Марк Минервини)

Тихое накопление (Silent Accumulation)

Средний объем за последние 20 дней увеличился по сравнению с предыдущими 20 днями, есть дни всплесков, но ценовой диапазон за те же 20 дней остается в пределах ±8% → накопление крупными игроками, скрытое от рынка.

Переход в конце Stage 1

Участок перехода от боковика на дне (Stage 1) к плавному росту (начало Stage 2).

• Наклон MA60 выше, чем месяц назад

• MA20 > MA60 (краткосрочный разворот вверх)

• Цена закрытия > MA60 (обеспечена поддержка)

• Ширина BB ≤ среднее за 20 дней (волатильность еще не расширена)

🔎 Шпаргалка по параметрам предварительного фильтра

Общие для скринера Momentum

Общие для скринера Breakout

📦 Установка

Предварительные требования

• Python 3.13+

• uv (рекомендуется)

Настройка

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

🚀 Использование

Интеграция с Claude Desktop

Добавьте следующее в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Прямой запуск

uv run python server.py

💬 Примеры диалогов

Анализ отдельной акции

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

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

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

Скрининг (скачущая лошадь)

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

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

Скрининг (лошадь, которая скоро побежит)

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

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

Диагностика стратегии отдельной акции

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

📋 Примеры вывода

Результаты скрининга Momentum (резюме)

{
  "스크리닝일": "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 (резюме)

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

🧩 Технологический стек

• FastMCP — фреймворк сервера MCP

• pykrx — данные Корейской биржи

• yfinance — данные Yahoo Finance

• ta — индикаторы технического анализа

• BeautifulSoup + lxml — парсинг HTML Naver Finance / Yahoo Screener

• pandas — обработка данных

📚 Ссылки

• Уильям Дж. О'Нил — Как делать деньги на акциях (CANSLIM)

• Марк Минервини — Торгуй как мастер фондового рынка (Trend Template, VCP)

• Ричард Вайкофф — теория накопления/распределения цены и объема

• Стэн Вайнштейн — Секреты получения прибыли на бычьем и медвежьем рынках (анализ стадий)

📄 Лицензия

MIT