openkrx-mcp

openkrx-mcp

MCP server that provides Korean Exchange (KRX) Open API market data as tools, covering indices, stocks, ETPs, bonds, derivatives, commodities, and ESG.

Category
Visit Server

README

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

# streamable-http (원격, 세션 없는 stateless 모드)
KRX_API_KEY=<YOUR_API_KEY> MCP_TRANSPORT=streamable-http PORT=8000 uvx openkrx-mcp

Docker

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

컨테이너는 기본적으로 MCP_TRANSPORT=streamable-http로 기동되며, http://localhost:8000/mcp 엔드포인트로 JSON-RPC 요청을 보내면 됩니다(세션 없는 stateless 모드 — 매 요청이 독립적으로 처리되며 Mcp-Session-Id 헤더가 필요 없습니다).

curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

참고

  • 데이터는 2010년 이후 일별 데이터이며, 매일 오전 8시(KST)에 갱신됩니다.
  • 날짜 파라미터(basDd)는 YYYYMMDD 형식입니다.
  • API 호출 한도: 10,000건
  • mcp SDK는 >=1.9.0,<2.0.0으로 버전을 고정하고 있습니다 — 2.0.0부터 mcp.server.fastmcp 모듈 구조가 크게 바뀌어 상한 없이 설치하면 빌드가 깨지니 주의하세요.

라이선스

MIT

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured