Initial commit

README.md

@@ -0,0 +1,59 @@
+# 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