Skip to content

jjlabsio/korea-stock-mcp

MCP Data & Storage

An MCP Server for Korean stock analysis using OPEN DART API and KRX API

TypeScript Latest v1.4.0 · 2mo ago Security brief →

Features

  • Search corporate disclosures by company and date
  • Provide parsed data from original disclosure reports
  • Offer detailed financial analysis based on XBRL
  • Supply KRX daily stock prices and basic stock information

Recent releases

View all 5 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

compare changes

🚀 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

compare changes

🚀 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

compare changes

🚀 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_sectionget_disclosuresection_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
138
Forks
27
Languages
TypeScript JavaScript Shell
Downloads/week
14 ↓91%
NPM Maintainers
2
Contributors
1

Install & Platforms

Install via
npm

Beta — feedback welcome: [email protected]