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
1 maintainer
Metadata
1 maintainer
Release files for openkrx-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| openkrx_mcp-0.1.1.tar.gz | 49.7 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| openkrx_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 58.8 kB
Release files / openkrx_mcp-0.1.1.tar.gz
| Download URL | openkrx_mcp-0.1.1.tar.gz |
|---|---|
| Size | 49.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6588ae17c5f568b6a75dfe1e2edca2c19064467a04616487f83367fa3d7fd534
|
|
BLAKE2b-256 checksum How to use checksums |
b25c884bdac1f75412d58a6ced2f6be5118e33dee3bb6bf88cc3afa1042937bb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / openkrx_mcp-0.1.1-py3-none-any.whl
| Download URL | openkrx_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 9.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
91093abf6931364e54c571f19b08884321c1ecb44e2ff0694e371d53438447c8
|
|
BLAKE2b-256 checksum How to use checksums |
7ed994bb73f794f5a590a96550fecb0ca603ede4f2274b33b2352e868d793021
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for openkrx-mcp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
