Openkrx

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

지원 API (31개)

설치 및 사용

사전 준비

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