본문 바로가기
M MCP모아

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

키움증권 공식 REST API MCP (kiwoom-spec·exec) — 키움증권이 직접 공개한 OpenAPI MCP 2종, 명세 검색과 시세·계좌 조회

Kiwoom-Securities/Kiwoom-REST-API

키움증권 공식 REST API MCP는 키움증권이 직접 공개한 로컬 서버로, API 명세 검색과 시세·계좌 조회를 지원하고 주문은 기본 비활성입니다.

키움증권 공식 실험적 사용 주의

⚖ 서비스 약관 라이선스

운영사가 제공하는 원격 서비스로 오픈소스가 아닙니다. 이용 조건은 운영사 약관을 확인하세요.

API 키 필요 ★ 79 업데이트 2개월 전
Claude Code Cursor Cline Codex 호환

설치

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

claude mcp add -e APP_KEY=your_app_key -e APP_SECRET=your_app_secret -e KIWOOM_MODE=demo kiwoom-exec -- uv run --frozen --directory /path/to/Kiwoom-REST-API/mcp_exec kiwoom-exec-mcp

이 MCP가 해결하는 문제

증권사 API는 명세가 방대해 AI가 엔드포인트와 파라미터를 추측하기 쉽고, 계좌 연동 시 주문 사고 위험도 큽니다. 이 서버는 명세 검색 서버와 실행 서버를 나누고, 주문 도구를 환경변수 게이트 뒤에 두며, 기본값을 모의투자로 둡니다. 키움증권이 직접 관리하는 저장소라 API 변경을 따라가기 쉽습니다.

보안 점검

2026-11-16 점검
사용 주의

키움증권 공식 저장소의 로컬 stdio 서버로 레드플래그는 없으나, 실계좌 조회·주문 도구를 포함하고 앱 키가 클라이언트 설정 env에 들어가므로 사용 방식에 유의해야 합니다.

통과한 점검

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

유의사항

  • 저장소 소유 조직 Kiwoom-Securities는 LICENSE.md의 저작권자(키움증권 주식회사), 저장소 홈페이지(openapi.kiwoom.com), mcp_exec 매니페스트 작성자 표기, 2026-09-10 보도(MCP·플러그인 공개)로 키움증권 공식으로 확인했습니다.
  • kiwoom-exec는 kwcli(PyPI) CLI인 kiwoomcli를 subprocess로 실행합니다. 인자는 리스트로 전달되고 shell=True는 쓰지 않으며 stdin은 DEVNULL로 끊습니다. eval·exec·postinstall은 확인되지 않았습니다.
  • APP_KEY·APP_SECRET은 MCP 클라이언트 설정의 env에 넣는 방식이라 설정 파일에 평문으로 남습니다. 대안으로 kiwoomcli setup(OS 자격 증명 저장소)과 KIWOOM_PROFILE을 쓸 수 있습니다. 도구 인자로 키를 받지는 않습니다.
  • 주문 도구는 KIWOOM_MCP_ALLOW_ORDERS=1일 때만 등록되고 기본 꺼짐이며, 기본 KIWOOM_MODE는 demo입니다. 실전(real) 모드와 주문 허용을 함께 켜면 실제 자금이 오갈 수 있고, confirm 값은 AI도 설정할 수 있습니다.
  • KIWOOM_MCP_TRANSPORT=http로 원격 HTTP 서버로도 띄울 수 있으나 기본은 stdio이며, 이 항목은 로컬 실행을 기준으로 점검했습니다.
  • 라이선스는 모든 권리 보유(LICENSE.md)로 OpenAPI 이용 목적에 한해 사용을 허락하며 복제·배포·수정·상업적 이용은 서면 동의가 필요합니다. 조회 결과(계좌 정보 포함)는 연결한 AI 서비스로 전달됩니다.

데이터·키 전송 대상

키움증권 OpenAPI (kiwoomcli/kwcli 경유)raw.githubusercontent.com (kiwoom-spec이 예제 코드를 조회)

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

한국어 사용 예시

API 명세와 예제 코드 찾기

키움 REST API에서 국내주식 현재가를 조회하는 API 명세와 예제 코드를 찾아줘

모의투자 계좌 잔고 조회

모의투자 모드로 내 계좌의 예수금과 보유 종목을 조회해줘

종목 시세 조회

삼성전자(005930)의 현재가와 호가를 알려줘

자주 묻는 질문

앱 키는 어디서 발급받나요?

키움증권 OpenAPI 포털(https://openapi.kiwoom.com/main/home)에서 App Key와 App Secret을 발급받습니다. 운영(real)과 모의투자(demo)는 키가 서로 다릅니다. kiwoom-spec 서버는 키 없이 쓸 수 있고, 조회를 실행하는 kiwoom-exec만 키가 필요합니다.

AI가 실제 주문을 낼 수 있나요?

주문 도구(kiwoom_order_preview, kiwoom_order_submit)는 KIWOOM_MCP_ALLOW_ORDERS가 정확히 1일 때만 등록되며 기본은 꺼져 있습니다. 전송은 confirm=true가 있어야 하지만 README는 confirm을 AI도 설정할 수 있으니 클라이언트의 도구 승인 UI에서 사람이 확인하고 자동 승인을 쓰지 말라고 안내합니다. 먼저 demo 모드에서 확인하세요.

같은 조직의 Kiwoom-Plugin과 기존 kiwoom-mcp는 무엇이 다른가요?

Kiwoom-Plugin(Kiwoom-Securities/Kiwoom-Plugin)은 같은 조직이 공개한 Claude Code 플러그인으로 kw_mcp 디렉터리와 .mcp.json을 포함하며, 설치는 저장소의 SETUP-PLUGIN.md를 따릅니다. 디렉토리에 이미 있는 kiwoom-mcp는 개인이 만든 비공식 조회 전용 서버로 이 항목과 별개입니다.

연동 API

키움증권 OpenAPI 키움 REST API

관련 MCP

키움증권 REST API MCP

java-jaydev/kiwoom-mcp

실험적 보안 점검 통과

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

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

한국투자증권 트레이딩 MCP

koreainvestment/open-trading-api

공식 실험적 사용 주의

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

금융·DART·주식 한국투자증권 OPEN APIKIS Developers API 키 필요
★ 1,677 ↓ 80/주 2일 전
Claude Code Cursor Cline

다올투자증권 MCP 트레이딩

다올투자증권 공식

공식 실험적 사용 주의

다올투자증권 계좌의 잔고·시세 조회와 주문을 AI에 연결하는 로컬 MCP

금융·DART·주식 다올투자증권 OpenAPI API 키 필요
↓ 29/주 1개월 전
Claude Code Cursor Cline

관련 가이드

전체 MCP 가이드 보기 →

리뷰 · 후기

후기 내려받기(CSV)
–

0개의 후기

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

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