본문 바로가기
M MCP모아

MCP모아는 정보 제공 목적입니다. 보안·라이선스·동작 책임은 이용자에게 있습니다.

한국투자증권 트레이딩 MCP — 한국투자증권 공식 OPEN API 기반 국내외 주식·선물옵션 시세·잔고·주문 MCP 서버

koreainvestment/open-trading-api

한국투자증권이 직접 만든 공식 MCP 서버로, 국내외 주식·선물옵션 시세 조회와 주문을 AI 대화로 처리합니다.

한국투자증권 공식 실험적 사용 주의 ⚖ MIT API 키 필요 ★ 1,677 업데이트 2일 전
Claude Code Cursor Cline 호환

설치

터미널에서 실행하세요. 기본은 이 프로젝트 전용(local, ~/.claude.json)으로 저장됩니다. 팀과 공유하려면 --scope project(프로젝트 루트 .mcp.json), 모든 프로젝트에서 쓰려면 --scope user 를 붙이세요. 확인: claude mcp list 또는 Claude Code 세션 안에서 /mcp

claude mcp add -e KIS_APP_KEY=your_app_key -e KIS_APP_SECRET=your_app_secret -e KIS_PAPER_APP_KEY=your_paper_app_key -e KIS_PAPER_APP_SECRET=your_paper_app_secret -e KIS_HTS_ID=your_hts_id -e KIS_ACCT_STOCK=12345678 -e KIS_ACCT_FUTURE=87654321 -e KIS_PAPER_STOCK=11111111 -e KIS_PAPER_FUTURE=22222222 -e KIS_PROD_TYPE=01 kis-trading -- npx -y @koreainvestment/kis-trading-mcp

이 MCP가 해결하는 문제

증권사 OPEN API는 종류가 많고 인증·파라미터 구조가 복잡해 AI 에이전트가 직접 호출하기 어렵습니다. 이 서버는 한국투자증권이 공식으로 제공하는 래퍼로, 국내외 주식·선물옵션·채권 API 166개를 도구 하나로 묶어 종목명 검색부터 시세·잔고 조회, 주문까지 대화로 처리하게 합니다. 모의투자와 실전 환경을 구분해 실행할 수 있어 먼저 모의투자로 시험해 볼 수 있습니다.

보안 점검

2026-11-16 점검
사용 주의

공식 증권사 저장소로 악성 요소는 없으나, 실행 시마다 저장소 main 브랜치의 파이썬 코드를 내려받아 subprocess로 실행하고 앱키·계좌번호를 평문 파일에 저장하며 실주문이 가능한 서버입니다.

통과한 점검

  • 데이터·API키 외부 유출 없음
  • 악성 설치 스크립트 없음
  • 하드코딩 크리덴셜·백도어 없음
  • 제3자 서버 경유 없음

유의사항

  • 변경 확인 — 영향 없음: 변경 3커밋은 examples_llm·examples_user 의 시세 예제 파일뿐(네트워크·셸·크리덴셜 추가 없음). npm 0.1.0(10-08) 유지, maintainer 동일. 다만 이 경로의 코드는 main 브랜치에서 실행 시 내려받아 실행되므로 저장소 변경이 곧 실행 코드 변경임
  • 각 API 호출마다 koreainvestment/open-trading-api main 브랜치의 examples_llm 코드와 kis_auth.py를 raw.githubusercontent.com에서 내려받아 임시 디렉터리에서 subprocess.run으로 실행합니다. 코드 출처는 공식 저장소이지만 저장소 변경이 곧바로 실행 코드에 반영되는 구조입니다.
  • 서버 시작 시 앱키·시크릿·HTS ID·계좌번호를 ~/KIS/config/kis_devlp.yaml에 평문 YAML로 저장하고, 발급 토큰도 로컬 파일에 저장합니다. 외부 전송은 확인되지 않았습니다.
  • 고정 실행 템플릿에 eval이 있으나 'ka._TRENV.' 접두사가 아닌 식은 거부하고, 계좌번호·HTS ID 같은 파라미터는 LLM 입력값을 무시하고 저장된 설정으로 덮어씁니다.
  • 종목 마스터파일 다운로드 시 ssl._create_unverified_context로 인증서 검증을 끕니다(download.dws.co.kr 대상).
  • 주문 API(order_cash, order_credit 등)가 포함되어 실전 앱키 설정 시 실제 주문이 가능합니다. env_dv 기본값은 demo(모의투자)입니다.
  • SSE·HTTP 모드는 MCP_ACCESS_TOKEN이 없으면 기동하지 않으며 기본 바인딩은 127.0.0.1입니다.
  • package.json의 postinstall·preinstall 스크립트는 없습니다. npx 진입점(bin/cli.js)이 uv sync로 파이썬 의존성을 설치한 뒤 서버를 실행합니다.
  • MIT 라이선스(MCP 폴더 LICENSE), 최신 커밋 2026-10-27, 하드코딩 크리덴셜은 발견되지 않았습니다.

데이터·키 전송 대상

openapi.koreainvestment.com (한국투자증권 OPEN API)raw.githubusercontent.com/koreainvestment (API 코드·설정 템플릿 다운로드)new.real.download.dws.co.kr (종목 마스터파일 다운로드)

GitHub 저장소 직접 점검 — README·매니페스트(package.json/pyproject)·서버 소스·설치 스크립트·패키지 레지스트리(npm/PyPI/JSR) 대조. 공개 소스 기준의 자동+수동 검토 의견이며 완전성·무오류를 보증하지 않습니다. 시점 이후 변경될 수 있습니다.

한국어 사용 예시

국내 종목 현재가 조회

모의투자 환경에서 삼성전자 현재가와 호가 정보를 알려줘

해외주식 시세 확인

애플(AAPL) 해외주식 현재 체결가를 알려줘

계좌 잔고 점검

국내주식 잔고를 조회하고 보유 종목별 평가손익을 정리해줘

자주 묻는 질문

API 키는 어떻게 발급받나요?

한국투자증권 개발자 센터(KIS Developers)에서 OPEN API 서비스를 신청한 뒤 앱키와 시크릿을 발급받아 KIS_APP_KEY, KIS_APP_SECRET 환경변수로 넣습니다. 모의투자는 KIS_PAPER_APP_KEY, KIS_PAPER_APP_SECRET을 별도로 사용합니다. 한국투자증권 계좌가 필요합니다.

실제 주문도 나가나요?

네. 주문 관련 API(order_cash, order_credit 등)가 포함되어 있어 실전 앱키와 계좌번호를 설정하면 실제 주문이 가능합니다. 도구 호출의 env_dv 기본값은 모의투자(demo)이며, README는 실전 투자 전 모의투자 연습을 권장하고 모든 투자 책임이 사용자에게 있다고 고지합니다.

같은 저장소의 다른 MCP나 kis-ai-extensions와는 어떻게 다른가요?

MCP 폴더에는 이 트레이딩 서버 외에 API 검색·샘플코드 생성용 KIS Code Assistant MCP(@koreainvestment/kis-code-assistant-mcp)가 함께 있습니다. 별도 저장소 koreainvestment/kis-ai-extensions는 전략 설계·백테스팅·주문 실행용 AI 에이전트 플러그인(@koreainvestment/kis-quant-plugin)이며, 백테스팅 엔진 연결용 MCP 서버를 포함한다고 안내되어 있습니다.

연동 API

한국투자증권 OPEN API KIS Developers

관련 MCP

키움증권 REST API MCP

java-jaydev/kiwoom-mcp

실험적 보안 점검 통과

키움증권 REST API로 현재가·호가·차트·계좌 잔고를 조회하는 읽기 전용 MCP 서버

금융·DART·주식 키움증권 REST API(OpenAPI) API 키 필요
★ 4 8개월 전
Claude Code Cursor Cline

토스증권 CLI·MCP (tossctl)

JungHoonGhae/tossinvest-cli

실험적 사용 주의

토스증권 비공식 CLI·MCP — 공식 Open API와 웹 내부 API로 시세·자산·주문 조회

금융·DART·주식 토스증권 Open API토스증권 WTS(웹 내부 API) API 키 필요
★ 522 2일 전
Claude Code Cursor Cline

한국 주식 MCP 서버

jjlabsio/korea-stock-mcp

실험적 보안 점검 통과

DART·KRX 공식 API로 한국 주식 분석을 AI와 함께 수행하는 MCP 서버

금융·DART·주식 DARTKRX 보통
★ 185 ↓ 177/주 3개월 전
Claude Code Cursor

관련 가이드

전체 MCP 가이드 보기 →

리뷰 · 후기

후기 내려받기(CSV)
–

0개의 후기

설치해보셨다면 다른 분들을 위해 평가를 남겨주세요.

아직 후기가 없습니다. 첫 후기를 남겨주세요!