shuim 85cb5cbc09 fix: 감사 잔여 항목 — 잔량 출처 DB화·ORB 영속화·미국 부분청산·듀얼전략 태깅·NULL 가격
- portfolio_cache_bridge: 잔량 산출을 Portfolio(DB) 기준으로. 캐시는 sync 실패 시 최대
  5분 낡아 실제와 다른 잔량이 기록될 수 있었음(감사 #14). 조회 실패 시 캐시 폴백.
- ORB 캐시 Redis 영속화(save/load_orb_cache) — 재배포 시 인메모리가 날아가 당일 ORB
  전략이 통째로 불가능했음. 수집 후 저장, 스케줄러 기동·수집 시 복원.
- us_market_scheduler: 부분청산이 Portfolio.quantity 를 갱신하지 않던 문제 → reflect_sell 연동.
- 듀얼 전략(MOMENTUM_BREAKOUT/PULLBACK_BUY)이 ActiveTrade.strategy_name 에 저장되지 않아
  CLAUDE.md §8.4 모멘텀 전용 청산(+10%/+20% 분할)이 한 번도 실행된 적 없었음 → 태깅 전달.
  매도 시에는 실제 행의 strategy_name 으로 close (swing 으로 닫으면 유령 행 잔존).
- 수동매도: current_price NULL 시 TypeError 로 주문 후 상태 갱신이 통째로 누락되던 엣지 수정.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-23 11:11:20 +09:00
2026-02-23 16:01:17 +09:00
2026-03-28 11:45:37 +09:00
2026-02-24 11:38:35 +09:00
2026-02-26 11:19:23 +09:00
2026-03-28 11:45:37 +09:00
2026-02-22 17:23:20 +09:00
2026-02-22 17:23:20 +09:00
2026-02-22 17:23:20 +09:00
2025-11-14 11:05:31 +09:00
2026-02-26 14:40:12 +09:00
2026-02-26 11:19:23 +09:00
2026-02-22 17:23:20 +09:00
2026-02-22 17:23:20 +09:00
2026-02-26 14:40:12 +09:00
2026-02-22 17:23:20 +09:00
2026-02-22 17:23:20 +09:00
2026-02-22 17:23:20 +09:00
2026-02-22 17:23:20 +09:00

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/           # 배포 스크립트

빠른 시작

# 환경 변수 설정
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

Description
No description provided
Readme 11 MiB
Languages
Python 90.6%
TypeScript 8.6%
Shell 0.5%
CSS 0.1%