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