jjlabsio/korea-stock-mcp
MCP Data & StorageAn MCP server that provides AI‑driven analysis of Korean stock prices and disclosure data using the official DART and KRX APIs
Features
- Search corporate disclosures by company and date
- Parse and expose original disclosure report data
- Perform XBRL‑based detailed financial statement analysis
- Retrieve daily KRX (KOSPI/KOSDAQ) stock prices and basic stock information
Recent releases
View all 6 releases →
v1.4.0
New feature
Notable features
- Include all companies in proxy JSON with compact keys
- Add English name search and partial matching to get_corp_code
Full changelog
🚀 Enhancements
- Include all companies in proxy JSON with compact keys (3b4bfe1)
- Add English name search and partial matching to get_corp_code (bf8a183)
🩹 Fixes
- Use --follow-tags to prevent duplicate tag push on release (e48d959)
- Lower MAX_RESULT_BYTES to 200KB to prevent context overflow (bfc51bd)
- Guide AI to web-search Korean name before corp code lookup (415fc41)
📖 Documentation
- Add tip for breaking complex questions into steps (e1a8206)
- Add Inventera IPO foreign allocation example (4dec1d0)
- Add English example files and update README links (7d945a3)
❤️ Contributors
- 송재진 (@jjlabsio)
v1.3.0
Bug fix
Notable features
- Add corp code JSON generation script
- Add GitHub Pages corp code proxy fetch
- Use GitHub Pages proxy for corp code lookup with DART fallback
Full changelog
🚀 Enhancements
- Add corp code JSON generation script (a068b3c)
- Add GitHub Pages corp code proxy fetch (8d20b87)
- Use GitHub Pages proxy for corp code lookup with DART fallback (9f50b7e)
🩹 Fixes
- Filter listed companies only in proxy JSON and add DART fallback for unlisted lookups (ed2fc53)
- Use npx tsx directly to avoid npm stdout prefix in generated JSON (77976e6)
📖 Documentation
- Add GitHub Pages corp code proxy implementation plan (148b6f8)
🤖 CI
- Add daily corp code update workflow (209837b)
❤️ Contributors
- 송재진 (@jjlabsio)
v1.2.0
New feature
Notable features
- Added stock_code lookup support in get_corp_code
- Fixed XML number parsing for accurate results
Full changelog
🚀 Enhancements
- Support stock_code lookup in get_corp_code and fix XML number parsing (306d7bb)
🩹 Fixes
- Show meaningful DART API error instead of ZIP parse failure in get_corp_code (35e40e7)
- Surface DART/KRX API errors instead of cryptic MCP errors (b1ecc4f)
- Use parseTagValue:false in error XML parser to prevent status code coercion (35282ea)
- Clarify stock_code format (6-digit) in corp_name search failure message (e0d1632)
- Check npm login before release to prevent partial releases (a80cb16)
💅 Refactors
- Extract shared DART error validation and unify error message format (49123a3)
🏡 Chore
- Automate changelog and GitHub release notes with changelogen (8e68948)
❤️ Contributors
- 송재진 (@jjlabsio)
v1.1.6
Breaking risk
Breaking changes
- `get_disclosure_section` is removed and integrated into `get_disclosure` via a new optional `section_id` parameter.
Notable features
- Automatic response adjustment for large disclosure XML documents
- `get_disclosure` now accepts an optional `section_id` parameter to retrieve specific sections
Full changelog
변경 사항
Features
- 대용량 공시 문서 처리 지원: 공시 XML 크기에 따라 응답을 자동으로 조정하는 기능 추가
- AI 가이드 TOC 응답: TOC 응답에 섹션 탐색을 위한 AI 안내 메시지 추가로 사용성 향상
get_disclosure에 선택적section_id파라미터 추가 (get_disclosure_section통합)
Fixes
- dotenv stdout 로그가 MCP JSON 파싱 오류를 유발하던 문제 수정
_truncated플래그가 실제 잘림 상태를 정확히 반영하도록 수정- forward scan에서 정확한 태그 매칭 및 안전한 UTF-8 잘림 처리 수정
Refactoring
get_disclosure_section툴을get_disclosure에 통합하여 API 단순화
Chore
- 릴리즈 스크립트를 순차 실행 방식으로 변경하여 버전 선택이 가능하도록 수정
업데이트 안내
get_disclosure_section은get_disclosure의section_id파라미터로 통합되었습니다.- 대용량 공시 문서를 다룰 때 자동으로 섹션 분할 방식을 제안합니다.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
About
Stars
158
Forks
34
Languages
TypeScript
JavaScript
Dockerfile
Downloads/week
14
↓91%
NPM Maintainers
2
Contributors
3
Install & Platforms
Install via
npm