KIS Code Assistant MCP로 투자 전략 구현 : 골든 크로스

이정진·2025년 9월 29일

KIS MCP

목록 보기

1/3

자동매매 시스템을 만들기 위해서는 단순히 전략 아이디어만으로는 부족합니다. 금융사 API를 깊이 이해하고 이를 직접 구현해야 하며, 이 과정에 상당한 시간과 노력이 요구됩니다.

그래서 한국투자증권과 함께 이 문제를 해결하기 위해 KIS Code Assistant MCP(Model Context Protocol) 를 개발했습니다. 이는 증권사 최초로 MCP를 활용해, 한국투자증권 OpenAPI를 훨씬 더 쉽고 직관적으로 다룰 수 있도록 돕는 도구입니다.

이제는 복잡한 코드와 씨름할 필요 없이, KIS Code Assistant MCP를 AI 도구에 연동해 나만의 투자 전략을 빠르게 자동매매 시스템으로 구현하고 실행까지 이어갈 수 있습니다.

이번 글에서는 KIS Code Assistant MCP를 활용해 골든크로스/데드크로스 전략 기반 자동매매 시스템을 구축하는 과정을 직접 수행해 보겠습니다.

자연어로 자동매매 투자 시스템 구축 : 골든 크로스

주식 투자에서 기술적 분석은 필수적인 도구입니다. 특히 골든크로스(Golden Cross)와 데드크로스(Dead Cross)는 가장 널리 알려진 매매 신호 중 하나로, 단기 이동평균선이 장기 이동평균선을 상향 돌파하거나 하향 돌파할 때 발생하는 패턴입니다.

지금부터 커서에 연동한 KIS Code Assistant MCP를 통해 골든 크로스 투자 전략을 자동매매 시스템을 빠르게 구현해 보겠습니다.

KIS Code Assistant MCP 연동

Cursor에서 자동매매 시스템 파일을 저장하기 위한 폴더를 오픈합니다
KIS Code Assistant MCP 연결을 확인합니다.

MCP 연결 설정 가이드 : https://github.com/koreainvestment/open-trading-api/blob/main/MCP/MCP AI 도구 연결 방법.md
프롬프트를 단계적으로 작성해 코드를 구현합니다.

프롬프트를 더 상세하게 전달하기 위해 프롬프트 도우미가 KIS Code Assistant MCP에 함께 설치됩니다. kis_detailed_code, kis_easy_code 두가지 버전이 준비되어 있습니다.
- 사용법 : 대화창에 “ / “ 입력 후 노출되는 메뉴에서 한국투자 코딩도우미 2개중 선택 → 커맨드 팔레트(상단 입력창)에 프롬프트를 입력하세요.
프롬프트 작성 가이드
- 단계적으로 접근하세요
  
  자동매매 시스템은 여러 컴포넌트가 유기적으로 연결된 복합 시스템입니다. 처음부터 완성된 시스템을 요구하기보다는 다음 순서로 단계별 구축을 요청하세요:
  
  1단계: 기본 프레임워크 (API 연결, 클래스 구조)
  
  2단계: 전략 구현 (기술적 지표 + 매매 로직)
  
  3단계: 실행 시스템 (주문 처리 + 스케줄링)
  
  4단계: 최적화 (성능 개선 + 리스크 관리)
  
  5단계: 고도화 (백테스팅 + 추가 기능)
  
  중요: 각 단계는 하나씩 따로 요청하고, 이전 단계가 정상 작동하는지 확인한 후 다음 단계로 진행하세요.
  
  올바른 요청 예시
  
  1단계: "KIS API를 활용해서 실시간 주가 데이터를 받아올 수 있는 기본 구조를 만들어 주세요"
  
  2단계: "5일/20일 이동평균 골든크로스 전략과 필요한 지표 계산을 구현해 주세요"
  
  3단계: "매수/매도 신호가 발생하면 실제 주문을 처리하는 시스템을 추가해 주세요"
  
  4단계: "손절매와 포지션 관리 기능을 추가해 주세요"
  
  잘못된 요청 예시
  "1~5단계를 모두 포함한 완전한 자동매매 시스템을 한 번에 만들어 주세요"
- 구체적인 표현을 사용하세요
  
  모호한 요청보다는 명확하고 측정 가능한 조건을 제시하세요
  
  구체적으로 명시해야 할 요소들
  - 대상 종목 또는 종목군
  - 사용할 기술적 지표와 수치
  - 매수/매도 조건
  - 포지션 크기 결정 방법
  - 손절/익절 조건
  올바른 요청 예시
  "KOSPI200 ETF(069500)를 대상으로, 5일 이동평균이 20일 이동평균을 상향 돌파할 때 매수하고, RSI가 70을 넘으면 매도하는 전략을 구현해주세요"
  
  잘못된 요청 예시
  "수익성이 좋은 매매 전략을 만들어주세요"
- 적정 수준의 조건으로 요청하세요.
  
  한 번의 요청에는 3-5개 정도의 핵심 조건으로 제한하는 것이 적절합니다. 너무 많은 조건을 동시에 요구하면 복잡성이 기하급수적으로 증가하여 오류 발생 가능성이 높아집니다.
  적절한 조건 예시
  - 매수 조건 2개
  - 매도 조건 2개
  - 리스크 관리 조건 1개
  과도한 요청 예시
  - 10개 이상의 기술적 지표
  - 복합적인 시장 상황 판단 로직
  - 다수 종목 동시 관리
  - 실시간 뉴스 분석까지 포함

개발 과정 예시

1단계 : 시작 프롬프트 작성

자동매매 프로그램을 만들고 싶어. 골든크로스/데드크로스 전략을 사용하고,
 종목은 하루에 한번씩 거래량 상위 10개 종목으로 교체할 예정이야.
 전략은 나중에 바꿀 수 있게 분리된 구조로 만들어줘.
 
 먼저 **기본 구조**부터 만들자.
 KIS API 연결하고, config.py 설정 파일 만들고, 기본 클래스 구조 설계해줘.
 AutoTradingBot, StockSelector, PortfolioManager 같은 클래스들로 나눠서 만들어줘.

프롬프트 작성 가이드에 맞춰 기본 구조 구축을 먼저 요청합니다. 자연어로 요청하기 위해서 kis_ease_code를 사용해 보겠습니다. kis_ease_code는 KIS Code Assistant MCP에게 Open api를 효과적으로 검색/활용하도록 안내하는 최소한의 개발 가이드 역할을 담당합니다. 첫 프롬프트에 사용을 권장합니다.

슬래시(/)를 입력하면 리스트가 노출되고 선택하면 커맨트 팔레트가 활성화됩니다.

작성해놓은 프롬프트를 입력하고 엔터키를 입력하세요. 대화창에 추가되면 send 버튼을 클릭하세요.

Cursor가 KIS Code Assistant MCP를 통해 필요한 Open api 자동으로 검색하고 분석해 투자자가 요청한 내용에 맞는 코드를 작성합니다.

작업을 끝낸 후 사용한 한국투자증권 Open api와 파일 구조, 클래스 등을 간략하게 정리해 주어, 내용을 빠르게 파악할 수 있습니다.

테스트를 요청해 보니 오류코드를 확인해가며, 빠르게 디버깅을 진행합니다.

테스트 결과를 정리해 주는 것뿐만 아니라, 다음 단계 안내를 통해 시스템에 대한 아이디어도 제공합니다. 제안해 준 아이디어를 기반으로 프롬프트를 조정하는 것도 좋은 방법입니다. 예제는 기존 계획대로 프롬프트를 요청하겠습니다.

단계별로 프롬프트를 작성하여, 시스템을 고도화합니다.

2단계 프롬프트

  골든크로스/데드크로스 전략을 만들어줘. 5일 이동평균과 20일 이동평균을 사용하고,
  크로스 발생했을 때 매수/매도 신호를 생성하도록 해줘.
  trading_strategies.py 파일로 분리해서 구현해줘.

3단계 프롬프트

  전략도 완성됐으니 이제 실제로 작동하는 시스템을 만들어보자.
  실제 주문 처리 기능과 5분마다 자동으로 시장을 분석하는 스케줄링 시스템을 추가해줘.
  모의투자 환경에서 실제로 돌아가도록 main 파일을 만들어줘.

4단계 프롬프트

 급락할 때 자동으로 손절하는 시스템과 수익이 나면 일부 매도하는 기능을 추가해줘.
 그리고 최대 10개 종목으로 포트폴리오를 제한하는 관리 기능도 넣어줘.

5단계 프롬프트

 과거 데이터로 백테스팅할 수 있는 시스템을 만들어줘.
 수익률, 최대낙폭, 승률 같은 성과 지표도 계산해서
 자동으로 리포트를 만들어주는 기능도 추가해줘.

시스템 구축

cursor가 개발한 시스템을 실행하면 다음과 같은 화면이 나옵니다.

(모의투자로 진행하였고, 예시 화면을 위해 특정 종목 호출로 조건을 수정한 상태입니다.)

시스템 구축 시 유의점

환경 설정

계좌정보, 앱키 등 민감정보 유출에 주의하여 관리해야 합니다.

모의투자 vs 실전투자: 처음에는 반드시 모의투자로 시작(모의투자 지원여부 확인 필요)
API 키 관리: kis_devlp.yaml 파일 별도 경로 관리
안전성 유지 : kis_auth.py 파일 구조 수정 예외 처리
계좌번호: 8자리 종합계좌번호 확인

점진적 기능 확장

기본 뼈대를 만들고 점진적으로 기능을 확장합니다.

1차: 기본 골든크로스 전략
2차: 추가 매수 기회 (오후 시간대 추가 스케쥴링)
3차: 고빈도 매수 (2분당 실행)
4차: 고급 리스크(급락 감지 방어) 관리

마무리하며

KIS Code Assistant MCP를 통해 복잡한 개발 지식 없이도 자동매매 시스템을 빠르게 구축할 수 있음을 확인했습니다. 하지만 기술적 도구는 투자를 위한 도구일뿐, 결코 투자 성공을 보장하지 않습니다.

실제 운용 전 반드시 기억하세요.

🔸 충분한 백테스팅: 과거 데이터로 전략의 유효성을 꼭 검증하세요

🔸 리스크 관리: 손절매와 포지션 사이징 규칙을 명확히 설정하세요

🔸 시장 상황 고려: 횡보장, 상승장, 하락장에서의 다양한 상황에서 전략의 효과를 분석하세요

🔸 소액부터 시작: 실제 자금은 투자 전략의 충분한 검증 후 단계적으로 투입하세요

🔸 면책 조항: 본 예제는 참고용으로 제공되는 것이며, 이를 활용해 발생하는 모든 투자 결과 및 손실에 대해서는 작성자가 어떠한 책임도 지지 않습니다. 최종적인 투자 판단과 책임은 전적으로 개인에게 있습니다.

자동매매 시스템은 투자의 감정적 요소를 제거하고 일관성을 유지하는 훌륭한 도구입니다. 하지만 시장은 끊임없이 변화하므로 지속적인 모니터링과 전략 개선이 필요합니다.

References

한국투자증권 OpenAPI 사이트
KIS MCP 소개 페이지
KIS 코딩 도우미 페이지
한국투자증권 Github
Github MCP 가이드
Github LLM 샘플
Smithery 코딩도우미 MCP 설치 페이지

이정진

라이브데이터 Developer

다음 포스트