loading…
Search for a command to run...
loading…
A Model Context Protocol server that wraps the Kiwoom Securities REST API to provide read-only access to Korean stock market information. It enables LLMs to que
A Model Context Protocol server that wraps the Kiwoom Securities REST API to provide read-only access to Korean stock market information. It enables LLMs to query real-time prices, charts, investor trends, and account balances directly.
키움증권 REST API를 Model Context Protocol (MCP) 도구로 래핑한 서버입니다. Claude Code 등 MCP를 지원하는 LLM 클라이언트에서 한국 주식 정보를 직접 조회할 수 있습니다.
현재 버전은 조회 전용입니다. 주문(매수/매도/취소) 기능은 포함되어 있지 않습니다.
이 소프트웨어를 사용함으로써 발생하는 모든 결과에 대한 책임은 전적으로 사용자 본인에게 있습니다.
.env 파일로 관리하세요.| 도구명 | 설명 | 입력 파라미터 |
|---|---|---|
get_stock_price |
현재가 조회 (종목명, 등락률, PER, PBR 등) | stockCode (6자리) |
get_orderbook |
호가 조회 (매도/매수 1~10호가, 잔량) | stockCode |
get_daily_chart |
일봉 차트 (시/고/저/종가, 거래량) | stockCode, baseDate? (YYYYMMDD) |
get_investor_trend |
투자자별 매매동향 (외국인/기관/개인 순매수) | stockCode |
get_account_balance |
계좌평가현황 (예수금, 보유종목, 손익률) | 없음 |
get_deposit |
예수금 상세 조회 (출금가능, 주문가능금액) | 없음 |
get_unfilled_orders |
미체결 주문 조회 | 없음 |
get_filled_orders |
체결 내역 조회 | stockCode? (미입력 시 전체) |
git clone https://github.com/java-jaydev/kiwoom-mcp.git
cd kiwoom-mcp
pnpm install
pnpm run build
pnpm이 없으면npm install && npm run build로도 가능합니다.
| 변수명 | 필수 | 설명 |
|---|---|---|
KIWOOM_APP_KEY |
O | 키움 OpenAPI App Key |
KIWOOM_SECRET_KEY |
O | 키움 OpenAPI Secret Key |
KIWOOM_API_BASE_URL |
X | API 베이스 URL (기본값: https://api.kiwoom.com) |
claude mcp add --transport stdio --scope user kiwoom \
--env KIWOOM_APP_KEY=<your-app-key> \
--env KIWOOM_SECRET_KEY=<your-secret-key> \
-- node /path/to/kiwoom-mcp/dist/index.js
프로젝트 루트에 .mcp.json 생성:
{
"mcpServers": {
"kiwoom": {
"type": "stdio",
"command": "node",
"args": ["/path/to/kiwoom-mcp/dist/index.js"],
"env": {
"KIWOOM_APP_KEY": "<your-app-key>",
"KIWOOM_SECRET_KEY": "<your-secret-key>"
}
}
}
}
.mcp.json에 API 키가 포함되므로 반드시.gitignore에 추가하세요.
설정 후 Claude Code를 재시작하고 /mcp 명령어로 서버 연결을 확인합니다.
# MCP Inspector로 로컬 테스트
npx @modelcontextprotocol/inspector node dist/index.js
# Claude Code에서 연동 확인
# /mcp 명령어로 서버 상태 확인 후 "삼성전자 현재가 알려줘" 등 질의
+/- 부호가 붙으며, 현재가 등은 절대값으로 변환하여 반환합니다.MIT License
이슈와 PR을 환영합니다. 단, API 키나 시크릿 키가 포함된 커밋은 절대 하지 마세요.
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"kiwoom-mcp": {
"command": "npx",
"args": []
}
}
}