kis_bot/mcp/kiwoom-docs-mcp

키움 REST API Docs MCP

키움증권 REST TR 스펙(kiwoom-rest-api-spec.json)을 조회만 하는 MCP입니다.
한투 kis-code-assistant MCP와 같은 역할(문서 검색)이며, 실제 API 호출·주문·토큰 발급은 하지 않습니다.

Tools

Tool	용도
kiwoom_api_stats	API 수·카테고리 분포
search_kiwoom_api	이름/설명/필드 키워드 검색
get_kiwoom_api	apiId 상세(requestIo/responseIo/예제)
list_kiwoom_apis	prefix·category·url 필터 목록
lookup_kiwoom_error	에러코드 조회

Cursor 등록

프로젝트 .cursor/mcp.json에 kiwoom-docs로 등록되어 있습니다.

# 수동 실행(스모크)
cd /home/hoon/kis_bot/mcp/kiwoom-docs-mcp
uv sync
uv run python server.py --stdio

데이터

• data/kiwoom-rest-api-spec.json — 키움 TR 카탈로그 (OpenAPI 아님)