Korea StockSAFE
MCP Server for Korean stock analysis. 한국 주식 분석을 위한 MCP 서버입니다.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
🇰🇷 한국어 | 🇺🇸 English
🚀 Korea Stock MCP가 오픈소스 MCP에서 한 단계 더 나아갑니다. 정확한 한국 주식 데이터를 바탕으로, AI가 더 믿을 수 있는 답변을 제공하도록 돕는 새로운 서비스를 준비하고 있습니다. 새로운 서비스의 방향을 확인해보세요.
한국 주식 분석을 위한 MCP 서버입니다. DART(전자공시시스템)와 KRX(한국거래소) 공식 API를 통해 주가 정보와 공시 자료 기반의 AI분석이 가능합니다.
💬 개선 요청 & 피드백 환영합니다! 사용하면서 불편한 점이나 개선 아이디어가 있으시면 편하게 이메일 주세요. 빠르게 확인하고 반영하겠습니다. 📧 [email protected]
🎯 주요 기능
- 🔍 공시검색 - 회사별, 기간별 공시 검색
- 📊 공시 데이터 - 공시보고서 원본파일 파싱한 데이터 제공
- 💼 재무제표 분석 - XBRL 기반 상세 재무 데이터
- 📈 주식 데이터 - KRX(코스피/코스닥) 일별 주가정보, 종목 기본정보
⚡ 빠른 시작
1️⃣ API KEY 발급
먼저 DART와 KRX의 API KEY를 발급받아야 합니다.
📝 DART API KEY 발급
- 회원가입: OPEN DART 회원가입
- 키 신청: 인증키 신청 페이지에서 API KEY 신청
- 키 확인: 오픈API 이용현황에서 발급된 API KEY 확인
📈 KRX API KEY 발급
- 회원가입: KRX OPEN API에서 회원가입 및 로그인
- 키 신청: 마이페이지 → API 인증키 신청에서 신청
- 서비스 신청: 승인 후 서비스이용 → 주식 메뉴로 이동
- API 이용신청: 다음 6개 항목에서 각각 "API 이용신청" 클릭
- 유가증권 일별매매정보
- 코스닥 일별매매정보
- 코넥스 일별매매정보
- 유가증권 종목기본정보
- 코스닥 종목기본정보
- 코넥스 종목기본정보
⏱️ 승인까지 약 1일 소요됩니다.
- 키 확인: 승인 후 마이페이지 → API 인증키 발급내역에서 API KEY 확인
2️⃣ Claude Desktop 설정
- Claude Desktop 실행
- 설정 → 개발자 → 구성편집 클릭
claude_desktop_config.json파일에 다음 내용 추가:
{
"mcpServers": {
"korea-stock-mcp": {
"command": "npx",
"args": ["-y", "korea-stock-mcp@latest"],
"env": {
"DART_API_KEY": "",
"KRX_API_KEY": ""
}
}
}
}- 재시작: Claude Desktop을 재시작하여 설정 적용
이제 Claude에서 한국 주식 데이터 분석을 시작할 수 있습니다.
대용량 공시 문서 처리
일부 공시보고서(사업보고서, 분기보고서 등)는 수 MB에 달하는 대용량 XML 문서입니다. 이런 문서를 한 번에 모두 처리하면 AI 응답 한도를 초과하거
2fbadceddc05OBSERVED · 2026-10-06Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add korea-stock-mcp --env DART_API_KEY=${DART_API_KEY} --env KRX_API_KEY=${KRX_API_KEY} -- npx -y [email protected]{
"mcpServers": {
"korea-stock-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"DART_API_KEY": "${DART_API_KEY}",
"KRX_API_KEY": "${KRX_API_KEY}"
}
}
}
}Exposed tools (8)
8 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
get_corp_code | read | 고유번호: DART에 등록되어있는 공시대상회사의 고유번호, 회사명, 종목코드를 제공합니다. 비상장법인도 조회 가능합니다. 회사명(corp_name, 한글 또는 영문) 또는 종목코드(stock_code) 중 하나로 조회할 수 있습니다. 회사명은 부분 일치 검색을 지원하므로 정확한 이름을 몰라도 조회할 수 있습니다. IMPORTANT: 한글 회사명을 정확히 모르는 경우(예: 영문명만 아는 경우), 반드시 웹 검색으로 정확한 한글 정식 명칭을 먼저 확인한 뒤 corp_name에 입력하세요. |
get_disclosure | read | DART API를 통해 공시보고서 원본파일을 파싱해 가져옵니다. 문서가 큰 경우(1MB 초과) 목차(type: |
get_disclosure_list | read | 공시검색: 공시 유형별, 회사별, 날짜별 등 여러가지 조건으로 공시보고서 검색기능을 제공합니다. 최근 공시를 검색할때는 bgn_de를 반드시 지정하세요. |
get_financial_statement | read | 재무제표: 상장법인(유가증권, 코스닥) 및 주요 비상장법인(사업보고서 제출대상 & IFRS 적용)이 제출한 정기보고서 내에 XBRL재무제표의 모든계정과목을 제공합니다. |
get_market_type | read | DART에 등록되어 있는 종목의 상장시장 정보를 제공합니다. Y(유가), K(코스닥), N(코넥스), E(기타) |
get_stock_base_info | read | 코스피, 코스닥, 코넥스에 상장되어있는 종목의 기준일에 해당하는 한글 종목명, 영문 종목명, 상장일, 주식종류, 액면가, 상장주식수 등의 정보를 제공합니다. codeList에 종목코드가 포함된 종목들의의 정보만 추출됩니다. basDd 하나당 KRX API를 한번씩 호출합니다. |
get_stock_trade_info | read | 코스피, 코스닥, 코넥스에 상장되어있는 종목의 기준일에 해당하는 종가, 등락률, 시가, 고가, 저가, 거래량, 거대금, 시총액, 상장주식수 등의 정보를 제공합니다. codeList에 종목코드가 포함된 종목들의의 정보만 추출되어 제공됩니다. basDd 하나당 KRX API를 한번씩 호출합니다. |
get_today_date | read | 오늘 날짜를 KST, UTC 기준 YYYYMMDD 형식으로 제공합니다. |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (4 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (1)
@modelcontextprotocol/sdk, adm-zip, dotenv, fast-xml-parser, zod, @changesets/cli, @types/adm-zip, @types/node
Gates applied: no_behavioural_pass.
2fbadceddc05full audit observations/trust-audit/mcp-server/jjlabsio__korea-stock.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-06 | 2fbadceddc05 | SAFE | B | 89 | first audit |
Questions
What is the Korea Stock MCP server?
MCP Server for Korean stock analysis. 한국 주식 분석을 위한 MCP 서버입니다.
What tools does Korea Stock expose?
8 in total: 8 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Korea Stock safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does Korea Stock need?
It reads DART_API_KEY and KRX_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does Korea Stock run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as korea-stock-mcp at 1.4.1.
How current is this page?
The grade is for one exact copy of the source (2fbadceddc05), read on 2026-10-06. The repository is watched and re-audited when it changes.