키움증권 REST API MCP
java-jaydev/kiwoom-mcp
키움증권 REST API로 현재가·호가·차트·계좌 잔고를 조회하는 읽기 전용 MCP 서버
MCP모아는 정보 제공 목적입니다. 보안·라이선스·동작 책임은 이용자에게 있습니다.
Kiwoom-Securities/Kiwoom-REST-API
키움증권 공식 REST API MCP는 키움증권이 직접 공개한 로컬 서버로, API 명세 검색과 시세·계좌 조회를 지원하고 주문은 기본 비활성입니다.
터미널에서 실행하세요. 기본은 이 프로젝트 전용(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 ~/.cursor/mcp.json (또는 프로젝트 .cursor/mcp.json) 에 추가
{
"mcpServers": {
"kiwoom-exec": {
"command": "uv",
"args": [
"run",
"--frozen",
"--directory",
"/path/to/Kiwoom-REST-API/mcp_exec",
"kiwoom-exec-mcp"
],
"env": {
"APP_KEY": "your_app_key",
"APP_SECRET": "your_app_secret",
"KIWOOM_MODE": "demo"
}
}
}
} Cline MCP 설정의 cline_mcp_settings.json 에 추가
{
"mcpServers": {
"kiwoom-exec": {
"command": "uv",
"args": [
"run",
"--frozen",
"--directory",
"/path/to/Kiwoom-REST-API/mcp_exec",
"kiwoom-exec-mcp"
],
"env": {
"APP_KEY": "your_app_key",
"APP_SECRET": "your_app_secret",
"KIWOOM_MODE": "demo"
}
}
}
} 증권사 API는 명세가 방대해 AI가 엔드포인트와 파라미터를 추측하기 쉽고, 계좌 연동 시 주문 사고 위험도 큽니다. 이 서버는 명세 검색 서버와 실행 서버를 나누고, 주문 도구를 환경변수 게이트 뒤에 두며, 기본값을 모의투자로 둡니다. 키움증권이 직접 관리하는 저장소라 API 변경을 따라가기 쉽습니다.
키움증권 공식 저장소의 로컬 stdio 서버로 레드플래그는 없으나, 실계좌 조회·주문 도구를 포함하고 앱 키가 클라이언트 설정 env에 들어가므로 사용 방식에 유의해야 합니다.
통과한 점검
유의사항
데이터·키 전송 대상
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만 키가 필요합니다.
주문 도구(kiwoom_order_preview, kiwoom_order_submit)는 KIWOOM_MCP_ALLOW_ORDERS가 정확히 1일 때만 등록되며 기본은 꺼져 있습니다. 전송은 confirm=true가 있어야 하지만 README는 confirm을 AI도 설정할 수 있으니 클라이언트의 도구 승인 UI에서 사람이 확인하고 자동 승인을 쓰지 말라고 안내합니다. 먼저 demo 모드에서 확인하세요.
Kiwoom-Plugin(Kiwoom-Securities/Kiwoom-Plugin)은 같은 조직이 공개한 Claude Code 플러그인으로 kw_mcp 디렉터리와 .mcp.json을 포함하며, 설치는 저장소의 SETUP-PLUGIN.md를 따릅니다. 디렉토리에 이미 있는 kiwoom-mcp는 개인이 만든 비공식 조회 전용 서버로 이 항목과 별개입니다.
java-jaydev/kiwoom-mcp
키움증권 REST API로 현재가·호가·차트·계좌 잔고를 조회하는 읽기 전용 MCP 서버
koreainvestment/open-trading-api
한국투자증권 공식 OPEN API 기반 국내외 주식·선물옵션 시세·잔고·주문 MCP 서버
다올투자증권 공식
다올투자증권 계좌의 잔고·시세 조회와 주문을 AI에 연결하는 로컬 MCP
0개의 후기
설치해보셨다면 다른 분들을 위해 평가를 남겨주세요.
리뷰를 작성하려면 GitHub 로그인이 필요합니다.
GitHub로 로그인하고 리뷰 쓰기아직 후기가 없습니다. 첫 후기를 남겨주세요!