openkrx-mcp 0.1.0

KRX(한국거래소) Open API MCP Server - 주식, 채권, 파생상품, ETF/ETN/ELW, 지수, 일반상품, ESG 시세정보

OpenKRX MCP Server

한국거래소(KRX) Open API를 MCP(Model Context Protocol) 도구로 제공하는 서버입니다.

지원 API (31개)

카테고리	도구 수	내용
지수 (idx)	5	KRX/KOSPI/KOSDAQ/채권/파생상품 지수 일별시세
주식 (sto)	8	KOSPI/KOSDAQ/KONEX 일별매매정보 + 종목기본정보
ETP (etp)	3	ETF/ETN/ELW 일별매매정보
채권 (bon)	3	국채/일반채권/소액채권 일별매매정보
파생상품 (drv)	6	선물/옵션 일별매매정보 (KOSPI/KOSDAQ 주식선물·옵션 포함)
일반상품 (gen)	3	석유/금/배출권 시장 일별매매정보
ESG (esg)	3	SRI채권/ESG ETP/ESG 지수 정보

설치 및 사용

사전 준비

KRX Open API에서 회원가입 후 API 인증키를 발급받으세요.

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "openkrx": {
      "command": "uvx",
      "args": ["openkrx-mcp"],
      "env": {
        "KRX_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Claude Code

claude mcp add openkrx -e KRX_API_KEY=<YOUR_API_KEY> -- uvx openkrx-mcp

직접 실행

# stdio (로컬)
KRX_API_KEY=<YOUR_API_KEY> uvx openkrx-mcp

# SSE (원격)
KRX_API_KEY=<YOUR_API_KEY> uvx openkrx-mcp --transport sse --port 8000

Docker

docker build -t openkrx-mcp .
docker run -e KRX_API_KEY=<YOUR_API_KEY> -p 8000:8000 openkrx-mcp

참고

• 데이터는 2010년 이후 일별 데이터이며, 매일 오전 8시(KST)에 갱신됩니다.
• 날짜 파라미터(basDd)는 YYYYMMDD 형식입니다.
• API 호출 한도: 10,000건

라이선스

MIT