# Auto Stock Trading System with MCP

Claude AI와 MCP(Model Context Protocol)를 활용한 한국 주식 자동매매 시스템

## 시스템 아키텍처

- **Frontend**: React + TypeScript + Vite
- **Backend**: Python FastAPI + WebSocket
- **MCP Server**: Claude AI 통합
- **Database**: PostgreSQL
- **Cache**: Redis
- **Message Queue**: RabbitMQ
- **API**: 한국투자증권 API

## 주요 기능

1. **실시간 시장 데이터 수집**
2. **Claude AI 기반 규칙 검증**
3. **자동 매매 실행**
4. **포트폴리오 관리**
5. **실시간 모니터링**

## 프로젝트 구조

```
auto-stock/
├── frontend/          # React 프론트엔드
├── backend/           # FastAPI 백엔드
├── mcp-server/        # MCP 서버
├── docker/            # Docker 설정
└── scripts/           # 배포 스크립트
```

## 빠른 시작

```bash
# 환경 변수 설정
cp .env.example .env

# Docker로 전체 시스템 시작
./scripts/deploy.sh

# 개발 모드
./scripts/dev.sh
```

## 환경 변수

`.env` 파일에 다음 설정 필요:

- `KOREA_INVESTMENT_APP_KEY`: 한국투자증권 앱키
- `KOREA_INVESTMENT_APP_SECRET`: 한국투자증권 시크릿
- `ANTHROPIC_API_KEY`: Claude API 키
- `DATABASE_URL`: PostgreSQL 연결 URL
- `REDIS_URL`: Redis 연결 URL

## 라이센스

MIT