npm package: @mrbaeksang/korea-stock-analyzer-mcp
Description: Korean stock analyzer with 6 investment legends' strategies for Claude Desktop (MCP)
Author: Mrbaeksang
Latest version: 1.1.1

# Korea Stock Analyzer MCP Server

[English](#english) | [한국어](#korean)

---

<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

Add to Claude Desktop config:

```json
{
  "mcpServers": {
    "korea-stock-analyzer": {
      "command": "npx",
      "args": ["@mrbaeksang/korea-stock-analyzer-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개의 강력한 도구** - 주식 분석을 위한 완벽한 툴킷
- 🚀 **설정 불필요** - 즉시 사용 가능
- 🇰🇷 **한국 시장 특화** - 한국 주식 분석에 최적화

### 빠른 시작

Claude Desktop 설정에 추가:

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

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

### 사용 가능한 도구

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가지 성장성 체크리스트
- 🌍 **존 템플턴** - 최대 비관 시점 투자

### 설치 방법

#### NPM 패키지 사용 (권장)

```bash
npx @mrbaeksang/korea-stock-analyzer-mcp
```

#### 소스코드에서 빌드

```bash
# 저장소 복제
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` - 수치 계산

### 개발

```bash
# 의존성 설치
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](LICENSE) 파일을 참조하세요.

### 감사의 말

- [pykrx](https://github.com/sharebook-kr/pykrx) - 한국 주식 시장 데이터
- [Anthropic](https://anthropic.com) - Model Context Protocol
- 전설적인 투자자들의 투자 전략

### 지원

- 🐛 [이슈 리포트](https://github.com/Mrbaeksang/korea-stock-analyzer-mcp/issues)
- 💬 [토론](https://github.com/Mrbaeksang/korea-stock-analyzer-mcp/discussions)
- ⭐ 유용하다면 스타를 눌러주세요!

### 면책 조항

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

---

Made with ❤️ for Korean stock investors using Claude Desktop