Skip to main content
Glama
joohyukjung

openkrx-mcp

by joohyukjung

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 지수 정보

Related MCP server: krx-cli

설치 및 사용

사전 준비

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

Install Server
A
license - permissive license
B
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    A
    quality
    D
    maintenance
    MCP server that provides Korean stock market data including indices, top gainers, stock quotes, news, fundamentals, and buy recommendations. Enables LLMs to access real-time and historical Korean stock information.
    Last updated
    6
  • A
    license
    -
    quality
    C
    maintenance
    Enables AI agents to query real-time and historical Korean stock market data from KRX (Korea Exchange) including indices, stocks, ETFs, bonds, derivatives, and commodities via MCP tools and resources.
    Last updated
    46
    1
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Provides Korean Exchange (KRX) Open API data as MCP tools, supporting 31 APIs for indices, stocks, ETP, bonds, derivatives, commodities, and ESG.
    Last updated
    1
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    MCP server that provides tools to query Korean financial products (savings, deposits, pensions, mortgages, loans) via the FSS Open API, enabling search by company or product type.
    Last updated
    2
    MIT

View all related MCP servers

Related MCP Connectors

  • This MCP server provides seamless access to Malaysia's government open data, including datasets, w…

  • 7-factor stock scoring MCP server. US/HK/CN, 74 stocks. Free + Premium (USDC/Base). x402 ready.

  • MCP server exposing the Backtest360 engine API as tools for AI agents.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/joohyukjung/openkrx-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server