shuim 3eb38690fe fix: 자동매매 미작동 근본 원인 4개 수정
## 버그 수정 요약

### 1. 거래량 필터 오작동 (market_analyzer.py)
- acml_vol(당일 누적량, 장초 2~10만주)을 100만주 기준으로 필터
  → 전 종목이 필터에 걸려 추천 종목 0개
- 수정: 20일 평균 거래량(avg_vol_20) 기준 10만주 미만 필터로 교체

### 2. min_volume_ratio 기본값 1.0 미설정 (recommendations.py)
- get_rule_based_recommendations_realtime()에서 min_volume_ratio 누락
  → 기본값 1.0 적용, 장중 acml_vol/avg_vol_20≈0.1 → 전 종목 None 반환
- 수정: min_volume_ratio=0 명시 설정

### 3. KRX 호가단위 오류 (korea_investment_api.py)
- 계산된 주문가격이 호가단위(50/100/500/1000원 등) 불일치
  → 모의투자 "호가단위 오류"로 모든 주문 실패
- 수정: _round_to_krx_tick() 헬퍼 추가, 주문 전 올림 처리

### 4. MCP 서버 AI_PROVIDER 미전달 (docker-compose.dev.yml, mcp-server/config.py)
- mcp-server 서비스에 AI_PROVIDER 환경변수 누락 → 항상 Gemini 사용
- Gemini 무료 쿼터 소진 → /analyze 500 에러 → fail-open
- 수정: AI_PROVIDER=${AI_PROVIDER:-claude} 추가
- 수정: load_dotenv(override=True)로 빈 env var 덮어쓰기 허용

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-10 13:24:11 +09:00
2025-11-14 11:05:31 +09:00
2026-02-23 16:01:17 +09:00
2026-02-24 11:38:35 +09:00
2026-02-22 17:23:20 +09:00
2026-03-10 09:49:03 +09:00
2026-02-26 11:19:23 +09:00
2026-02-26 14:40:12 +09:00
2026-02-24 17:36:24 +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%