shuim
408bcce62e
감사에서 드러난 신뢰성·조용한실패 버그 수정. 전략값(§5)·시그니처(§4) 불변. ① KIS API 신뢰성(korea_investment_api, config): 스로틀에 _throttle_lock 추가로 thundering herd(8코루틴 동시발사) 제거, API_TIMEOUT 10→20초, circuit_breaker 임계 15→7, 재시도 백오프 지터. → 시간당 121건 실패의 근원 완화. ② portfolio summary 보존(portfolio): 잔고 API 실패 시 summary가 영영 None으로 남아 현금 0→매수 스킵되던 것을, 최초 실패 시 holdings 기반 부분 summary로 채움. ③ output2 빈리스트 가드: KIS가 output2=[] 반환 시 IndexError로 MDD 업데이트가 조용히 스킵(하방보호 비활성)되던 것 방어. swing/scheduler·adaptive_strategy (실버그) + daytrading 2곳(정규화). trade_executor:555는 load-bearing 가드라 의도적 미변경. ④ MIN_BUY_AMOUNT config화+소액완화(trade_executor, config): 하드코딩 50만을 MIN_BUY_AMOUNT_KRW로. 자산 833만↓ 계좌가 전종목 차단되던 것을 자산 대비로 완화(큰 계좌는 기존 50만 하한 불변). ⑤ adaptive 서브버그(adaptive_strategy): fallback 시 _last_update_ts 갱신(refresh 남발 방지), force_mode_override 전체필드(crisis의 max_daily_trades=0 실제 적용), get_event_loop→get_running_loop. 검증: code-verifier 통과(CONFIRMED 버그/회귀 없음, 4개 위험지점 안전), pytest 442 통과. (day_trading.py·entry_service.py는 소량 인접 선재편집 포함 — 검증 완료.) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HBmzf1HDnvFHLraJ8eaaKJ
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
주요 기능
- 실시간 시장 데이터 수집
- Claude AI 기반 규칙 검증
- 자동 매매 실행
- 포트폴리오 관리
- 실시간 모니터링
프로젝트 구조
auto-stock/
├── frontend/ # React 프론트엔드
├── backend/ # FastAPI 백엔드
├── mcp-server/ # MCP 서버
├── docker/ # Docker 설정
└── scripts/ # 배포 스크립트
빠른 시작
# 환경 변수 설정
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