kiwoom-mcp 0.1.0

MCP server for kiwoom-cli — 키움증권 REST API 236종을 AI 에이전트에 연결합니다

kiwoom-mcp (server)

이 디렉터리는 kiwoom-plugin의 MCP 서버 본체입니다. 플러그인이 uvx로 이 디렉터리를 직접 실행하므로 별도 배포(PyPI/npm)가 없습니다.

kiwoom-cli 236종 API를 MCP 도구로 노출합니다. 안전장치(주문 확인 게이트, dry-run, 멱등키, envelope)는 kiwoom-cli의 것을 그대로 통과시킵니다.

단독 실행

uvx --from "git+https://github.com/gejyn14/kiwoom-plugin@v0.1.0#subdirectory=server" kiwoom-mcp
uvx --from "git+https://github.com/gejyn14/kiwoom-plugin@v0.1.0#subdirectory=server" kiwoom-mcp --allow-orders

전송·인증·안전 모델은 상위 README를 참고하세요.

개발

pip install -e ".[dev]"
pytest tests/ -q
ruff check kiwoom_mcp/

도구

도구	설명
kiwoom_describe	명령 트리 조회
kiwoom_find	키워드로 명령·API 검색
kiwoom_run	임의의 kiwoom-cli 명령 실행
kiwoom_stream_snapshot	실시간 스트림에서 N개 이벤트
kiwoom_order_validate	주문 사전점검 (read-only)
kiwoom_order	주문 전송 — --allow-orders 시에만 등록

라이선스

Apache-2.0.