65 lines
1.6 KiB
Markdown
65 lines
1.6 KiB
Markdown
# 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
|
|
|
|
# 기본값
|
|
# - `DATABASE_URL`은 `.env.example`에 이미 도커 컨테이너(127.0.0.1:5432)를
|
|
# 가리키도록 설정되어 있습니다. 로컬 개발 시 별도 수정이 필요 없습니다.
|
|
# 원격 DB를 사용하려면 여기에 URL을 덮어쓰십시오.
|
|
|
|
# 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
|