Korea Stock MCP Server

1# Korea Stock MCP Server
2 
3[🇰🇷 한국어](#korea-stock-mcp-server) | [🇺🇸 English](#english-version)
4 
5한국 주식 분석을 위한 MCP 서버입니다.  
6DART(전자공시시스템)와 KRX(한국거래소) 공식 API를 통해 주가 정보와 공시 자료 기반의 AI분석이 가능합니다.
7 
8## 🎯 주요 기능
9 
10- 🔍 **공시검색** - 회사별, 기간별 공시 검색
11- 📊 **공시 데이터** - 공시보고서 원본파일 파싱한 데이터 제공
12- 💼 **재무제표 분석** - XBRL 기반 상세 재무 데이터
13- 📈 **주식 데이터** - KRX(코스피/코스닥) 일별 주가정보, 종목 기본정보
14 
15## ⚡ 빠른 시작
16 
17### 1️⃣ API KEY 발급
18 
19먼저 DART와 KRX의 API KEY를 발급받아야 합니다.
20 
21#### 📝 DART API KEY 발급
22 
231. **회원가입**: [OPEN DART](https://opendart.fss.or.kr) 회원가입
242. **키 신청**: [인증키 신청 페이지](https://opendart.fss.or.kr/uss/umt/EgovMberInsertView.do)에서 API KEY 신청
253. **키 확인**: [오픈API 이용현황](https://opendart.fss.or.kr/mng/apiUsageStatusView.do)에서 발급된 API KEY 확인
26 
27#### 📈 KRX API KEY 발급
28 
291. **회원가입**: [KRX OPEN API](https://openapi.krx.co.kr/contents/OPP/MAIN/main/index.cmd)에서 회원가입 및 로그인
302. **키 신청**: 마이페이지 → API 인증키 신청에서 신청
313. **서비스 신청**: 승인 후 서비스이용 → 주식 메뉴로 이동
324. **API 이용신청**: 다음 6개 항목에서 각각 "API 이용신청" 클릭
33 
34   - 유가증권 일별매매정보
35   - 코스닥 일별매매정보
36   - 코넥스 일별매매정보
37   - 유가증권 종목기본정보
38   - 코스닥 종목기본정보
39   - 코넥스 종목기본정보
40 
41   > ⏱️ **승인까지 약 1일 소요됩니다.**
42 
435. **키 확인**: 승인 후 마이페이지 → API 인증키 발급내역에서 API KEY 확인
44 
45### 2️⃣ Claude Desktop 설정
46 
471. **Claude Desktop** 실행
482. **설정** → **개발자** → **구성편집** 클릭
493. `claude_desktop_config.json` 파일에 다음 내용 추가:
50 
51```json
52{
53  "mcpServers": {
54    "korea-stock-mcp": {
55      "command": "npx",
56      "args": ["-y", "korea-stock-mcp@latest"],
57      "env": {
58        "DART_API_KEY": "<YOUR_DART_API_KEY>",
59        "KRX_API_KEY": "<YOUR_KRX_API_KEY>"
60      }
61    }
62  }
63}
64```
65 
664. **재시작**: Claude Desktop을 재시작하여 설정 적용
67 
68> 이제 Claude에서 한국 주식 데이터 분석을 시작할 수 있습니다.
69 
70## 사용 가능한 도구
71 
72### DART (전자공시시스템)
73 
741. **get_disclosure_list** - 공시검색
75 
76   - 공시 유형별, 회사별, 날짜별 공시보고서 검색
77 
782. **get_corp_code** - 고유번호 조회
79 
80   - DART 등록 공시대상회사의 고유번호, 회사명, 종목코드 제공
81 
823. **get_disclosure** - 공시보고서 원문
83 
84   - DART API를 통한 공시보고서 원본파일 파싱
85 
864. **get_financial_statement** - 재무제표
87   - 상장법인 및 주요 비상장법인 XBRL 재무제표
88   - 정기보고서 내 모든 계정과목 데이터 제공
89 
90### KRX (한국거래소)
91 
921. **get_stock_base_info** - 종목 기본정보
93 
94   - 코스피, 코스닥, 코넥스 상장 종목 기본 정보
95   - 종목명, 종목코드, 시장구분 등 기본 데이터
96 
972. **get_stock_trade_info** - 일별 매매정보
98   - 코스피, 코스닥, 코넥스 종목별 일별 거래 데이터
99   - 주가, 거래량, 시가총액 등 상세 거래 정보
100 
1013. **get_market_type** - 시장구분 조회
102   - 종목코드로 해당 종목의 시장구분(코스피/코스닥/코넥스) 조회
103   - 주식 데이터 조회 시 필요한 시장 정보 제공
104 
105### 기타 도구
106 
1071. **get_today_date** - 오늘 날짜 조회
108   - 현재 날짜를 YYYYMMDD 형식으로 제공
109   - AI의 정확한 날짜 조회를 위한 도구
110 
111## 실제 사용 예시
112 
113### 📊 재무 분석 예제
114 
115**프롬프트**: "삼양식품의 2023년, 2024년 1~4분기, 2025년 1,2분기 매출, 영업이익 조사해주고 성장률도 조사해줘"  
116→ [삼양식품 분석 결과 보기](./example/삼양식품.md)
117 
118**프롬프트**: "에이피알의 23년 1분기부터 25년 2분기까지의 매출, 영업이익 성장과 주가, 시가총액 흐름을 조사해줘"  
119→ [에이피알 분석 결과 보기](./example/에이피알.md)
120 
121### 🏢 기업 분석 예제
122 
123**프롬프트**: "HJ중공업은 뭘 해서 돈을 버는 회사인지랑 사업부문별 매출까지 같이 알려줘"  
124→ [HJ중공업 분석 결과 보기](./example/HJ중공업.md)
125 
126## API 데이터 소스
127 
128- **DART (전자공시시스템)**: 상장기업 공시 정보 및 재무제표
129- **KRX (한국거래소)**: 종목 기본정보 및 일별 매매정보
130 
131## 기여하기
132 
133기여를 환영합니다! Pull Request를 보내주세요.
134 
1351. 이 저장소를 포크하세요
1362. 기능 브랜치를 만드세요 (`git checkout -b feature/AmazingFeature`)
1373. 변경사항을 커밋하세요 (`git commit -m 'Add some AmazingFeature'`)
1384. 브랜치에 푸시하세요 (`git push origin feature/AmazingFeature`)
1395. Pull Request를 열어주세요
140 
141## 라이선스
142 
143ISC 라이선스
144 
145## 지원
146 
147- 🐛 이슈가 있다면 GitHub Issues에 등록해주세요
148- ⭐ 유용하다면 스타를 눌러주세요!
149 
150## 면책 조항
151 
152본 도구는 정보 제공 목적이며, 투자 조언이 아닙니다. 모든 투자 결정은 본인 책임입니다.
153 
154---
155 
156# English Version
157 
158MCP Server for Korean stock analysis.  
159Enables AI-powered analysis of stock prices and disclosure data through official APIs from DART (Data Analysis, Retrieval and Transfer System) and KRX (Korea Exchange).
160 
161## 🎯 Key Features
162 
163- 🔍 **Disclosure Search** - Search corporate disclosures by company and date
164- 📊 **Disclosure Data** - Provides parsed data from original disclosure reports
165- 💼 **Financial Statement Analysis** - Detailed financial data based on XBRL
166- 📈 **Stock Data** - KRX (KOSPI/KOSDAQ) daily stock prices and basic stock information
167 
168## ⚡ Quick Start
169 
170### 1️⃣ API KEY Registration
171 
172You need to obtain API KEYs from both DART and KRX.
173 
174#### 📝 DART API KEY Registration
175 
1761. **Sign Up**: Register at [OPEN DART](https://opendart.fss.or.kr)
1772. **Request Key**: Apply for API KEY at [Authentication Key Application Page](https://opendart.fss.or.kr/uss/umt/EgovMberInsertView.do)
1783. **Check Key**: Verify issued API KEY at [Open API Usage Status](https://opendart.fss.or.kr/mng/apiUsageStatusView.do)
179 
180#### 📈 KRX API KEY Registration
181 
1821. **Sign Up**: Register and login at [KRX OPEN API](https://openapi.krx.co.kr/contents/OPP/MAIN/main/index.cmd)
1832. **Request Key**: Apply for API authentication key in My Page → API Authentication Key Application
1843. **Service Application**: After approval, go to Service Use → Stock menu
1854. **API Usage Application**: Click "API Usage Application" for each of the following 6 items
186 
187   - Securities Daily Trading Information
188   - KOSDAQ Daily Trading Information
189   - KONEX Daily Trading Information
190   - Securities Basic Information
191   - KOSDAQ Basic Information
192   - KONEX Basic Information
193 
194   > ⏱️ **Approval takes approximately 1 day.**
195 
1965. **Key Verification**: After approval, check API KEY in My Page → API Authentication Key Issuance History
197 
198### 2️⃣ Claude Desktop Setup
199 
2001. Launch **Claude Desktop**
2012. Go to **Settings** → **Developer** → **Edit Configuration**
2023. Add the following content to `claude_desktop_config.json`:
203 
204```json
205{
206  "mcpServers": {
207    "korea-stock-mcp": {
208      "command": "npx",
209      "args": ["-y", "korea-stock-mcp@latest"],
210      "env": {
211        "DART_API_KEY": "<YOUR_DART_API_KEY>",
212        "KRX_API_KEY": "<YOUR_KRX_API_KEY>"
213      }
214    }
215  }
216}
217```
218 
2194. **Restart**: Restart Claude Desktop to apply settings
220 
221> You can now start analyzing Korean stock data with Claude.
222 
223## Available Tools
224 
225### DART (Data Analysis, Retrieval and Transfer System)
226 
2271. **get_disclosure_list** - Disclosure Search
228 
229   - Search disclosure reports by type, company, and date
230 
2312. **get_corp_code** - Corporate Code Inquiry
232 
233   - Provides unique codes, company names, and stock codes of DART-registered disclosure companies
234 
2353. **get_disclosure** - Disclosure Report Content
236 
237   - Parse original disclosure report files through DART API
238 
2394. **get_financial_statement** - Financial Statements
240   - XBRL financial statements for listed and major unlisted companies
241   - Provides all account data from periodic reports
242 
243### KRX (Korea Exchange)
244 
2451. **get_stock_base_info** - Basic Stock Information
246 
247   - Basic information for KOSPI, KOSDAQ, and KONEX listed stocks
248   - Basic data including stock names, codes, and market classifications
249 
2502. **get_stock_trade_info** - Daily Trading Information
251   - Daily trading data for KOSPI, KOSDAQ, and KONEX stocks
252   - Detailed trading information including stock prices, trading volume, and market capitalization
253 
2543. **get_market_type** - Market Type Inquiry
255   - Query market classification (KOSPI/KOSDAQ/KONEX) by stock code
256   - Provides market information needed for stock data queries
257 
258### Other Tools
259 
2601. **get_today_date** - Today's Date Inquiry
261   - Provides current date in YYYYMMDD format
262   - Tool for AI's accurate date inquiry
263 
264## Real Usage Examples
265 
266### 📊 Financial Analysis Examples
267 
268**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"  
269→ [See Samyang Foods Analysis Results](./example/삼양식품.md)
270 
271**Prompt**: "Investigate APR's sales and operating profit growth from Q1 2023 to Q2 2025, along with stock price and market cap trends"  
272→ [See APR Analysis Results](./example/에이피알.md)
273 
274### 🏢 Corporate Analysis Examples
275 
276**Prompt**: "Tell me what HJ SHIPBUILDING & CONSTRUCTION does to make money and include sales by business segment"  
277→ [See HJ SHIPBUILDING & CONSTRUCTION Analysis Results](./example/HJ중공업.md)
278 
279## API Data Sources
280 
281- **DART (Data Analysis, Retrieval and Transfer System)**: Listed company disclosure information and financial statements
282- **KRX (Korea Exchange)**: Basic stock information and daily trading information
283 
284## Contributing
285 
286Contributions are welcome! Please send us a Pull Request.
287 
2881. Fork this repository
2892. Create a feature branch (`git checkout -b feature/AmazingFeature`)
2903. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
2914. Push to the branch (`git push origin feature/AmazingFeature`)
2925. Open a Pull Request
293 
294## License
295 
296ISC License
297 
298## Support
299 
300- 🐛 If you have issues, please register them in GitHub Issues
301- ⭐ If you find it useful, please give it a star!
302 
303## Disclaimer
304 
305This tool is for informational purposes only and is not investment advice. All investment decisions are your own responsibility.
306