Provides access to DART (전자공시시스템) Korea's electronic disclosure system for searching corporate disclosures, retrieving company codes, accessing disclosure report content, and obtaining XBRL-based financial statements for listed and major unlisted Korean companies
Korea Stock MCP Server
한국 주식 분석을 위한 MCP 서버입니다.
DART(전자공시시스템)와 KRX(한국거래소) 공식 API를 통해 주가 정보와 공시 자료 기반의 AI분석이 가능합니다.
🎯 주요 기능
🔍 공시검색 - 회사별, 기간별 공시 검색
📊 공시 데이터 - 공시보고서 원본파일 파싱한 데이터 제공
💼 재무제표 분석 - 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
파일에 다음 내용 추가:
재시작: Claude Desktop을 재시작하여 설정 적용
이제 Claude에서 한국 주식 데이터 분석을 시작할 수 있습니다.
사용 가능한 도구
DART (전자공시시스템)
get_disclosure_list - 공시검색
공시 유형별, 회사별, 날짜별 공시보고서 검색
get_corp_code - 고유번호 조회
DART 등록 공시대상회사의 고유번호, 회사명, 종목코드 제공
get_disclosure - 공시보고서 원문
DART API를 통한 공시보고서 원본파일 파싱
get_financial_statement - 재무제표
상장법인 및 주요 비상장법인 XBRL 재무제표
정기보고서 내 모든 계정과목 데이터 제공
KRX (한국거래소)
get_stock_base_info - 종목 기본정보
코스피, 코스닥, 코넥스 상장 종목 기본 정보
종목명, 종목코드, 시장구분 등 기본 데이터
get_stock_trade_info - 일별 매매정보
코스피, 코스닥, 코넥스 종목별 일별 거래 데이터
주가, 거래량, 시가총액 등 상세 거래 정보
get_market_type - 시장구분 조회
종목코드로 해당 종목의 시장구분(코스피/코스닥/코넥스) 조회
주식 데이터 조회 시 필요한 시장 정보 제공
기타 도구
get_today_date - 오늘 날짜 조회
현재 날짜를 YYYYMMDD 형식으로 제공
AI의 정확한 날짜 조회를 위한 도구
실제 사용 예시
📊 재무 분석 예제
프롬프트: "삼양식품의 2023년, 2024년 1~4분기, 2025년 1,2분기 매출, 영업이익 조사해주고 성장률도 조사해줘"
→ 삼양식품 분석 결과 보기
프롬프트: "에이피알의 23년 1분기부터 25년 2분기까지의 매출, 영업이익 성장과 주가, 시가총액 흐름을 조사해줘"
→ 에이피알 분석 결과 보기
🏢 기업 분석 예제
프롬프트: "HJ중공업은 뭘 해서 돈을 버는 회사인지랑 사업부문별 매출까지 같이 알려줘"
→ HJ중공업 분석 결과 보기
API 데이터 소스
DART (전자공시시스템): 상장기업 공시 정보 및 재무제표
KRX (한국거래소): 종목 기본정보 및 일별 매매정보
기여하기
기여를 환영합니다! Pull Request를 보내주세요.
이 저장소를 포크하세요
기능 브랜치를 만드세요 (
git checkout -b feature/AmazingFeature
)변경사항을 커밋하세요 (
git commit -m 'Add some AmazingFeature'
)브랜치에 푸시하세요 (
git push origin feature/AmazingFeature
)Pull Request를 열어주세요
라이선스
ISC 라이선스
지원
🐛 이슈가 있다면 GitHub Issues에 등록해주세요
⭐ 유용하다면 스타를 눌러주세요!
면책 조항
본 도구는 정보 제공 목적이며, 투자 조언이 아닙니다. 모든 투자 결정은 본인 책임입니다.
English Version
MCP Server for Korean stock analysis.
Enables AI-powered analysis of stock prices and disclosure data through official APIs from DART (Data Analysis, Retrieval and Transfer System) and KRX (Korea Exchange).
🎯 Key Features
🔍 Disclosure Search - Search corporate disclosures by company and date
📊 Disclosure Data - Provides parsed data from original disclosure reports
💼 Financial Statement Analysis - Detailed financial data based on XBRL
📈 Stock Data - KRX (KOSPI/KOSDAQ) daily stock prices and basic stock information
⚡ Quick Start
1️⃣ API KEY Registration
You need to obtain API KEYs from both DART and KRX.
📝 DART API KEY Registration
Sign Up: Register at OPEN DART
Request Key: Apply for API KEY at Authentication Key Application Page
Check Key: Verify issued API KEY at Open API Usage Status
📈 KRX API KEY Registration
Sign Up: Register and login at KRX OPEN API
Request Key: Apply for API authentication key in My Page → API Authentication Key Application
Service Application: After approval, go to Service Use → Stock menu
API Usage Application: Click "API Usage Application" for each of the following 6 items
Securities Daily Trading Information
KOSDAQ Daily Trading Information
KONEX Daily Trading Information
Securities Basic Information
KOSDAQ Basic Information
KONEX Basic Information
⏱️ Approval takes approximately 1 day.
Key Verification: After approval, check API KEY in My Page → API Authentication Key Issuance History
2️⃣ Claude Desktop Setup
Launch Claude Desktop
Go to Settings → Developer → Edit Configuration
Add the following content to
claude_desktop_config.json
:
Restart: Restart Claude Desktop to apply settings
You can now start analyzing Korean stock data with Claude.
Available Tools
DART (Data Analysis, Retrieval and Transfer System)
get_disclosure_list - Disclosure Search
Search disclosure reports by type, company, and date
get_corp_code - Corporate Code Inquiry
Provides unique codes, company names, and stock codes of DART-registered disclosure companies
get_disclosure - Disclosure Report Content
Parse original disclosure report files through DART API
get_financial_statement - Financial Statements
XBRL financial statements for listed and major unlisted companies
Provides all account data from periodic reports
KRX (Korea Exchange)
get_stock_base_info - Basic Stock Information
Basic information for KOSPI, KOSDAQ, and KONEX listed stocks
Basic data including stock names, codes, and market classifications
get_stock_trade_info - Daily Trading Information
Daily trading data for KOSPI, KOSDAQ, and KONEX stocks
Detailed trading information including stock prices, trading volume, and market capitalization
get_market_type - Market Type Inquiry
Query market classification (KOSPI/KOSDAQ/KONEX) by stock code
Provides market information needed for stock data queries
Other Tools
get_today_date - Today's Date Inquiry
Provides current date in YYYYMMDD format
Tool for AI's accurate date inquiry
Real Usage Examples
📊 Financial Analysis Examples
Prompt: "Investigate Samyang Foods's sales and operating profit for Q1-Q4 2023, Q1-Q4 2024, and Q1-Q2 2025, and also check growth rates"
→ See Samyang Foods Analysis Results
Prompt: "Investigate APR's sales and operating profit growth from Q1 2023 to Q2 2025, along with stock price and market cap trends"
→ See APR Analysis Results
🏢 Corporate Analysis Examples
Prompt: "Tell me what HJ SHIPBUILDING & CONSTRUCTION does to make money and include sales by business segment"
→ See HJ SHIPBUILDING & CONSTRUCTION Analysis Results
API Data Sources
DART (Data Analysis, Retrieval and Transfer System): Listed company disclosure information and financial statements
KRX (Korea Exchange): Basic stock information and daily trading information
Contributing
Contributions are welcome! Please send us a Pull Request.
Fork this repository
Create a feature branch (
git checkout -b feature/AmazingFeature
)Commit your changes (
git commit -m 'Add some AmazingFeature'
)Push to the branch (
git push origin feature/AmazingFeature
)Open a Pull Request
License
ISC License
Support
🐛 If you have issues, please register them in GitHub Issues
⭐ If you find it useful, please give it a star!
Disclaimer
This tool is for informational purposes only and is not investment advice. All investment decisions are your own responsibility.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
MCP Server for Korean stock analysis