본문 바로가기
M MCP모아

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

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

java-jaydev/kiwoom-mcp

키움증권 REST API 키로 한국 주식 시세와 내 계좌 잔고를 AI에서 조회하는 조회 전용 비공식 MCP 서버입니다.

실험적 보안 점검 통과 ⚖ MIT API 키 필요 ★ 4 업데이트 8개월 전
Claude Code Cursor Cline 호환

설치

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

claude mcp add -e 'KIWOOM_APP_KEY=<your-app-key>' -e 'KIWOOM_SECRET_KEY=<your-secret-key>' kiwoom -- node /path/to/kiwoom-mcp/dist/index.js

이 MCP가 해결하는 문제

키움증권 REST API는 토큰 발급과 TR 코드별 요청 형식을 직접 다뤄야 해서 AI가 바로 쓰기 어렵습니다. 이 서버는 현재가·호가·차트·계좌 조회를 8개 도구로 감싸고 토큰 갱신과 재시도를 처리합니다. 주문 기능이 없는 조회 전용이라 AI가 매매를 실행할 위험 없이 시세와 잔고를 확인하는 용도로 쓸 수 있습니다.

보안 점검

2026-11-16 점검
보안 점검 통과

키움증권 API 도메인으로만 통신하는 소규모 조회 전용 서버로 레드플래그는 없으나, 소규모 초기 프로젝트이고 2026년 3월 이후 유지보수가 없습니다.

통과한 점검

  • 데이터·API키 외부 유출 없음
  • 악성 설치 스크립트 없음
  • 하드코딩 크리덴셜·백도어 없음
  • 임의 셸 실행 없음
  • 제3자 서버 경유 없음
  • 자격증명 평문 저장 없음

유의사항

  • App Key·Secret Key는 환경변수로만 받아 키움 /oauth2/token 엔드포인트에 전송합니다. 토큰은 메모리에만 캐시하고 파일로 저장하지 않으며 로그에는 만료 시각만 stderr로 출력합니다.
  • KIWOOM_API_BASE_URL 환경변수로 API 주소를 바꿀 수 있어 잘못된 값을 넣으면 키가 그 주소로 전송됩니다. 기본값은 https://api.kiwoom.com입니다.
  • 도구 8개는 모두 조회용이며 주문 API 호출 코드는 없습니다. 계좌평가현황·예수금·체결 내역 조회는 계좌 정보를 AI 대화로 노출하므로 해당 정보가 사용 중인 LLM 서비스로 전달됩니다.
  • child_process·eval 호출, postinstall 스크립트, 하드코딩 크리덴셜은 없고 의존성은 @modelcontextprotocol/sdk와 zod 두 개뿐입니다. npm에 게시된 패키지는 없어 소스를 직접 클론해 빌드해야 합니다.
  • 키움증권 공식 제품이 아닌 개인 프로젝트이며 공식 REST API를 사용하므로 비공식 API 스크래핑은 아닙니다.
  • MIT 라이선스, 커밋 5건, 최신 커밋 2026-03-06, 별 4개이며 테스트 코드는 없습니다. 토큰은 발급 IP에서만 유효합니다.

데이터·키 전송 대상

api.kiwoom.com (키움증권 REST API, KIWOOM_API_BASE_URL로 변경 가능)

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

한국어 사용 예시

현재가와 호가 확인

삼성전자(005930) 현재가와 매수·매도 10호가 잔량을 보여줘

일봉 차트 조회

SK하이닉스 최근 일봉 시가·고가·저가·종가와 거래량을 정리해줘

내 계좌 평가 현황

내 계좌의 예수금과 보유 종목별 평가금액, 손익률을 알려줘

자주 묻는 질문

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

키움 OpenAPI 포털(openapi.kiwoom.com)에서 REST API 사용을 신청하고 App Key와 Secret Key를 발급받아 KIWOOM_APP_KEY, KIWOOM_SECRET_KEY 환경변수로 넣습니다. 키움증권 계좌가 필요한 것으로 보이며 요금은 README에 명시되어 있지 않습니다.

주문도 낼 수 있나요?

아닙니다. README와 CHANGELOG 모두 현재 버전은 조회 전용이며 매수·매도·취소 기능은 포함되어 있지 않다고 밝힙니다.

어떻게 설치하고, 알려진 제약은 무엇인가요?

npm에 게시되어 있지 않아 저장소를 클론해 pnpm install, pnpm run build 후 dist/index.js를 node로 등록합니다(Node.js 18+). 토큰은 발급된 IP에서만 유효해 서버와 클라이언트가 같은 IP여야 하고, 투자자별 매매동향은 당일 거래량 상위 100종목만 조회됩니다.

연동 API

키움증권 REST API(OpenAPI)

관련 MCP

한국투자증권 트레이딩 MCP

koreainvestment/open-trading-api

공식 실험적 사용 주의

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

금융·DART·주식 한국투자증권 OPEN APIKIS Developers API 키 필요
★ 1,677 ↓ 80/주 2일 전
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개의 후기

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

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