kis_trader/mcp/ls-docs-mcp/README.md

LS증권 OpenAPI Docs MCP

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

Tools

Tool	용도
ls_api_stats	TR 수·카테고리/프로토콜 분포
search_ls_api	이름/설명/필드 키워드 검색 (예: 분봉, t8412, 조건검색)
get_ls_api	trCode 상세(requestIo/responseIo/예제/docsUrl)
list_ls_apis	category·protocol·url 필터 목록

Cursor 등록

프로젝트 .cursor/mcp.json에 ls-docs로 등록합니다.
Cursor MCP 재로드 후 도구가 보입니다.

cd /home/hoon/kis_bot/mcp/ls-docs-mcp
uv sync
uv run python server.py --stdio

데이터 갱신

공식 포털 공개 API에서 스펙을 받아 data/ls-openapi-spec.json을 만듭니다
(REST 시세/주문 호출 아님 — 문서 메타만).

cd /home/hoon/kis_bot/mcp/ls-docs-mcp
uv run python fetch_spec.py
# 로그: 표준출력. 약 1~3분 (TR~360 + 필드 조회, sleep 포함)

출처

• 그룹 목록: GET https://openapi.ls-sec.co.kr/api/apis/public?size=500
• TR 목록: GET https://openapi.ls-sec.co.kr/api/apis/guide/tr/{apiId}
• 필드: GET https://openapi.ls-sec.co.kr/api/apis/guide/tr/property/{trId}