Korea Stock Analyzer MCP Server

English | 한국어

---

<a name="english"></a>

🇺🇸 English

A Model Context Protocol (MCP) server that provides comprehensive Korean stock market analysis using strategies from 6 legendary investors.

Features

• 📊 Real-time Korean stock data - Direct access to KOSPI/KOSDAQ data via pykrx
• 🎯 6 Investment Strategies - Analysis based on proven methodologies
• 📈 7 Powerful Tools - Complete toolkit for stock analysis
• 🚀 Zero Configuration - Works out of the box
• 🇰🇷 Korean Market Focused - Optimized for Korean equity analysis

Quick Start

Choose your preferred installation method:

Option 1: NPX (Simplest)

npx @mrbaeksang/korea-stock-analyzer-mcp

Option 2: Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "korea-stock-analyzer": {
      "command": "npx",
      "args": ["-y", "@mrbaeksang/korea-stock-analyzer-mcp"]
    }
  }
}

Option 3: Remote MCP (Serverless)

{
  "mcpServers": {
    "korea-stock-analyzer": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://korea-stock-analyzer-mcp.vercel.app/api/mcp"]
    }
  }
}

Available Tools

1. get_financial_data - PER, PBR, EPS, ROE, dividend yield
2. get_technical_indicators - MA, RSI, MACD, 52-week high/low
3. calculate_dcf - Intrinsic value calculation
4. search_news - Latest news and sentiment
5. get_supply_demand - Institutional/foreign investor analysis
6. compare_peers - Industry peer comparison
7. analyze_equity - Complete analysis with all strategies

Example Usage

"Analyze Samsung Electronics stock"
"Calculate DCF for SK Hynix"
"Compare NAVER with Kakao"

Investment Strategies

• 🎩 Warren Buffett - Owner Earnings, ROE focus
• 📊 Peter Lynch - PEGY Ratio analysis
• 💼 Benjamin Graham - Graham Number valuation
• 🎯 Joel Greenblatt - Magic Formula ranking
• 🔍 Philip Fisher - 15-Point growth checklist
• 🌍 John Templeton - Maximum pessimism approach

---

<a name="korean"></a>

🇰🇷 한국어

6명의 전설적인 투자자들의 전략을 활용한 한국 주식 시장 종합 분석 MCP 서버입니다.

주요 기능

• 📊 실시간 한국 주식 데이터 - pykrx를 통한 KOSPI/KOSDAQ 직접 접근
• 🎯 6가지 투자 전략 - 검증된 투자 방법론 기반 분석
• 📈 7개의 강력한 도구 - 주식 분석을 위한 완벽한 툴킷
• 🚀 설정 불필요 - 즉시 사용 가능
• 🇰🇷 한국 시장 특화 - 한국 주식 분석에 최적화

설치 방법

🚀 방법 1: NPX 실행 (가장 간단)

# 즉시 실행 - 설치 불필요
npx @mrbaeksang/korea-stock-analyzer-mcp

📦 방법 2: NPM 글로벌 설치

# 글로벌 설치
npm install -g @mrbaeksang/korea-stock-analyzer-mcp

# 실행
korea-stock-analyzer

🤖 방법 3: Claude Desktop 설정

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "korea-stock-analyzer": {
      "command": "npx",
      "args": ["-y", "@mrbaeksang/korea-stock-analyzer-mcp"]
    }
  }
}

🛠️ 방법 4: Claude Code (자동 설정)

claude mcp add korea-stock -- npx -y @mrbaeksang/korea-stock-analyzer-mcp

🌐 방법 5: Remote MCP URL (서버리스)

{
  "mcpServers": {
    "korea-stock-analyzer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://korea-stock-analyzer-mcp.vercel.app/api/mcp"
      ]
    }
  }
}

💬 방법 6: 카카오 PlayMCP 🆕

카카오톡 AI 채팅에서 바로 사용! PlayMCP에서 "한국주식 AI 분석가"를 검색하세요.

🔧 방법 7: Smithery 자동 설치

npx -y @smithery/cli install korea-stock-analyzer --client claude

사용 가능한 도구

1. get_financial_data - PER, PBR, EPS, ROE, 배당수익률 조회
2. get_technical_indicators - 이동평균, RSI, MACD, 52주 최고/최저
3. calculate_dcf - DCF 기반 적정가치 계산
4. search_news - 최신 뉴스 및 감성 분석
5. get_supply_demand - 기관/외국인 수급 분석
6. compare_peers - 동종업계 비교 분석
7. analyze_equity - 모든 전략을 활용한 종합 분석

사용 예시

"삼성전자 주식 분석해줘"
"SK하이닉스 DCF 계산해줘"
"네이버와 카카오 비교해줘"
"현대차 수급 분석 보여줘"
"LG화학 기술적 지표 확인"

투자 전략

• 🎩 워런 버핏 - 오너 어닝스, 높은 ROE 중심
• 📊 피터 린치 - PEGY 비율 분석
• 💼 벤저민 그레이엄 - 그레이엄 수치 기반 평가
• 🎯 조엘 그린블라트 - 매직 포뮬러 순위
• 🔍 필립 피셔 - 15가지 성장성 체크리스트
• 🌍 존 템플턴 - 최대 비관 시점 투자

소스코드에서 빌드

# 저장소 복제
git clone https://github.com/Mrbaeksang/korea-stock-analyzer-mcp.git
cd korea-stock-analyzer-mcp

# 의존성 설치
npm install

# 빌드
npm run build

# 실행
npm start

요구사항

• Node.js 18 이상
• Python 3.9 이상 (자동 처리됨)
• Claude Desktop (MCP 통합용)

Python 의존성

서버가 자동으로 필요한 Python 패키지를 설치합니다:

• pykrx - 한국 주식 시장 데이터
• pandas - 데이터 처리
• numpy - 수치 계산

개발

# 의존성 설치
npm install

# 개발 모드 실행
npm run dev

# 프로덕션 빌드
npm run build

# 테스트 실행
npm test

프로젝트 구조

├── src/
│   ├── server.ts           # 메인 MCP 서버
│   ├── services/           # 핵심 서비스
│   │   ├── financial-data.ts  # 재무 데이터
│   │   ├── market-data.ts     # 시장 데이터
│   │   ├── supply-demand.ts   # 수급 분석
│   │   └── python-executor.ts # Python 실행
│   └── analyzers/          # 투자 전략
│       ├── buffett.ts      # 버핏 전략
│       ├── lynch.ts        # 린치 전략
│       ├── graham.ts       # 그레이엄 전략
│       ├── greenblatt.ts   # 그린블라트 전략
│       ├── fisher.ts       # 피셔 전략
│       └── templeton.ts    # 템플턴 전략

기여하기

기여를 환영합니다! Pull Request를 보내주세요.

라이선스

MIT 라이선스 - 자세한 내용은 LICENSE 파일을 참조하세요.

감사의 말

• pykrx - 한국 주식 시장 데이터
• Anthropic - Model Context Protocol
• 전설적인 투자자들의 투자 전략

지원

• 🐛 이슈 리포트
• 💬 토론
• ⭐ 유용하다면 스타를 눌러주세요!

면책 조항

이 도구는 교육 및 연구 목적으로만 사용하세요. 투자 조언이 아닙니다. 투자 결정 전 반드시 본인의 판단으로 결정하세요.

---

Made with ❤️ for Korean stock investors using Claude Desktop