한국투자증권 open-trading-api
한국투자증권, 韓 증권사 최초 AI 연동 투자프로그램 개발 서비스 출시
9월에 소식을 들었는데 이제야 여유가 생겨서 시작해본다.
한국투자증권은 인공지능(AI)과 직접 연동해 이용자가 손쉽게 투자 프로그램을 개발할 수 있도록 ‘MCP(Model Context Protocol)’ 서비스를 출시했다.
예를 들어 MCP 서비스를 활용해 ‘A주식이 5% 오르면 10주 매수하는 프로그램을 만들어줘’라는 간단한 프롬프트로 개인화된 트레이딩 도구를 구현할 수 있다고 한다.
한국투자증권 open-trading-api Github 링크
위 링크에서 레포를 clone해서 쓸 수 있다.
자세한 MCP 사용방법은 위의 링크를 참조했다.
한국투자증권은 MCP 두 가지를 소개한다.
- 한국투자 코딩도우미 MCP - KIS Code Assistant MCP
- 자연어 검색으로 관련 API를 찾고, 호출 예제(파라미터 포함)까지 자동 구성해주는 MCP 서버이다.
- “무엇을 하고 싶은지”만 말하면, 관련 API를 추천하고 예시 호출 코드를 만들어줌
- 한국투자 트레이딩 MCP - KIS Trading MCP
- 국내/해외주식, 선물·옵션, 채권, ETF/ETN, 인증 등 한국투자증권의 다양한 Open API를 MCP 서버의 “도구”로 래핑한 프로젝트
- LLM이 바로 사용할 수 있도록 API 스키마·파라미터를 리소스로 제공하고, 모의/실전 환경을 구분하여 안전하게 실행함
쉽게 말하면 1번은 내가 원하는 코드를 만드는 걸 도와주는 MCP고, 2번은 실제 trading에 필요한 정보들을 얻기 위한 API를 통해 데이터를 가져와주는 것.
환경 셋팅은 MCP 가이드 사이트에 잘 나와있다.
코딩 도우미 MCP를 셋팅하고 나면 최종 디렉토리 구조는 다음과 같다. (~는 local의 home)
~/KIS/
└── config/
└── devlp.yaml (보안 정보)
~/자동매매/
├── kis_auth.py
├── pyproject.toml
├── test_connection.py
├── .venv/ (uv sync 후 자동 생성)
└── uv.lock (uv sync 후 자동 생성)
트레이딩 MCP는 안전한 API 호출을 위해 로컬 도커 컨테이너에서 실행한다.
공식 가이드를 잘 따라가면서 위처럼 도커 이미지를 생성한다.
가이드에는 환경변수를 설정하여 컨테이너를 실행하라고 했는데, 이미 kis_devlp.yaml 파일에 환경 변수들을 설정해놔서 기존 kis_devlp.yaml을 그대로 쓰려고 명령어를 변경하여 실행했음.
docker run -d \
--name kis-trade-mcp \
-p 3000:3000 \
-v /Users/yeoni/Desktop/korea-trading/korea-invest-trading/kis_devlp.yaml:/app/config/kis_devlp.yaml \
kis-trade-mcp
즉, 맥에 있는 kis_devlp.yaml을 컨테이너 안 /app/config/kis_devlp.yaml로 연결해줌.
셋팅 다 하고 로컬 클로드에 MCP 활성해놓고 질문을 해보았다.
요청해야하는 API부터 방법을 친절하게 알려줌!
현재 구조가
Claude Desktop ↔ mcp-remote ↔ 로컬 MCP 서버(도커 컨테이너)
여서 도커가 떠 있어야만 MCP를 사용할 수 있다.
MCP 서버는 “항상 켜져 있는 HTTP 서버”이고, Claude는 그냥 “클라이언트”임.
그래서 MCP 이용 개발할때는 도커 띄워놓고 하면 될 듯.
매번 키기 귀찮고 까먹을 것 같기도 해서 도커의 Settings → General에서 “Start Docker Desktop when you log in” 체크해 놓음.
환경 셋팅을 완료했으니 본격적으로 개발해보자!