MyDart MCP

MCP server for Korean corporate disclosures (DART/OpenDART): filing search, financials, XBRL, auditor-grade audit-report parsing (opinions, KAM, going concern, ICFR findings), and valuation data

Documentation

๐Ÿ’ก

MyDart MCP๋ฅผ ์†Œ๊ฐœํ•ฉ๋‹ˆ๋‹ค. ํด๋กœ๋“œ์—์„œ MyDart MCP๋ฅผ ์—ฐ๊ฒฐํ•ด๋‘๋ฉด OpenDART API๋ฅผ ํ†ตํ•ด ํด๋กœ๋“œ๊ฐ€ DART์— ์žˆ๋Š” ๊ฐ์‚ฌ๋ณด๊ณ ์„œ์™€ ์žฌ๋ฌด์ •๋ณด๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ ๋Œ€๋‹ตํ•ด์ค๋‹ˆ๋‹ค.


MCP๋ฅผ ์—ฐ๊ฒฐํ•˜๋ฉด, ํด๋กœ๋“œ๊ฐ€ Dart์— ์˜ฌ๋ผ์˜จ ์ง„์งœ ์žฌ๋ฌด์ •๋ณด๋กœ ๋Œ€๋‹ตํ•ฉ๋‹ˆ๋‹ค.

ํ˜น์‹œ ํด๋กœ๋“œ(Claude)์—๊ฒŒ ํŠน์ • ํšŒ์‚ฌ์˜ ์žฌ๋ฌด์ •๋ณด๋‚˜ ๊ฐ์‚ฌ๋ณด๊ณ ์„œ ๋‚ด์šฉ์„ ๋ฌผ์–ด๋ณธ ์  ์žˆ์œผ์‹ ๊ฐ€์š”? ๋‹ต์€ ๊ทธ๋Ÿด๋“ฏํ•˜๊ฒŒ ๋Œ์•„์˜ค๋Š”๋ฐ, ์ž์„ธํžˆ ๋ณด๋ฉด ์ข€ ์ด์ƒํ•˜์ฃ . "์žˆ์„ ๋ฒ•ํ•œ" ๋ฌธ์žฅ์„ ์ง€์–ด๋‚ธ ๊ฒƒ์ด๊ธฐ ๋•Œ๋ฌธ์ž…๋‹ˆ๋‹ค. ๊ฐ์‚ฌยทํšŒ๊ณ„์ฒ˜๋Ÿผ ํ•œ ๊ธ€์ž๊ฐ€ ํ‹€๋ฆฌ๋ฉด ์•ˆ ๋˜๋Š” ์ผ์—์„  ์ด๋Œ€๋กœ ์“ธ ์ˆ˜๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค.

๊ทธ๋ ‡๋‹ค๊ณ  OpenDART์—์„œ ์ œ๊ณตํ•˜๋Š” API๋งŒ ์˜์กดํ•˜๊ธฐ์—๋Š” ๋„ˆ๋ฌด ์ •๋ณด๊ฐ€ ๋ถ€์กฑํ•ฉ๋‹ˆ๋‹ค. OpenDART API๋ฅผ ํ†ตํ•ด ํŠน์ • ๋…„๋„์˜ ๊ฐ์‚ฌ๋ณด๊ณ ์„œ ๊ฒฐ๊ณผ๋ฅผ ์š”์ฒญํ•˜๋ฉด ์ ์ • ํ•œ ๋‹จ์–ด๋งŒ ๋Œ์•„์˜ค์ฃ . ์ •์ž‘ ๊ถ๊ธˆํ•œ ํ•ต์‹ฌ๊ฐ์‚ฌ์‚ฌํ•ญ(KAM), ๊ฐ•์กฐ์‚ฌํ•ญ ๋ฌธ๋‹จ, ๊ณ„์†๊ธฐ์—… ๋ถˆํ™•์‹ค์„ฑ ์—ฌ๋ถ€, ๋‚ด๋ถ€ํšŒ๊ณ„๊ด€๋ฆฌ์ œ๋„ ์ค‘์š”ํ•œ ์ทจ์•ฝ์  ๊ฐ™์€ ๋‚ด์šฉ์€ API์—์„œ ์ œ๊ณต๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์ด๋Ÿฌํ•œ ๋ฌธ์ œ์ ์„ ํ•ด๊ฒฐํ•˜๊ธฐ ์œ„ํ•ด์„œ MyDart MCP๋ฅผ ๋งŒ๋“ค์—ˆ์Šต๋‹ˆ๋‹ค. ์ด MCP๋ฅผ ํ†ตํ•ด ํด๋กœ๋“œ์— ์‹ค์ œ Dart ๊ณต์‹œ๋ฅผ ์ฝ๊ณ  ํŒŒ์‹ฑํ•˜๋Š” ๋„๊ตฌ๋ฅผ ์ง์ ‘ ์—ฐ๊ฒฐํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ทธ๋Ÿฌ๋ฉด ํด๋กœ๋“œ๊ฐ€ DART์— ์˜ฌ๋ผ์™€์žˆ๋Š” ์‹ค์ œ ๋ณด๊ณ ์„œ์™€ ๋ฐ์ดํ„ฐ๋ฅผ ์—ด์–ด ๋Œ€๋‹ตํ•˜๊ฒŒ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ’ก

**MCP๊ฐ€ ๋ญ”๊ฐ€์š”?
MCP(Model Context Protocol)๋Š” ํด๋กœ๋“œ ๊ฐ™์€ AI์— ์™ธ๋ถ€ ๋„๊ตฌ์™€ ๋ฐ์ดํ„ฐ๋ฅผ ๋ถ™์ด๋Š” ํ‘œ์ค€ ๊ทœ๊ฒฉ์ž…๋‹ˆ๋‹ค. ํด๋กœ๋“œ ์ž…์žฅ์—์„  "์†๊ณผ ๋ˆˆ"์„ ๋‹ค๋Š” ์ผ์ด๊ณ , ํ•œ๋ฒˆ ์—ฐ๊ฒฐํ•ด๋‘๋ฉด ํ‰์†Œ ๋Œ€ํ™”ํ•˜๋“ฏ ํ•œ๊ตญ์–ด๋กœ ์‹œํ‚ค๊ธฐ๋งŒ ํ•˜๋ฉด ๋ฉ๋‹ˆ๋‹ค.


๋‹ค๋ฅธ DART MCP์™€์˜ ์ฐจ์ด์ , ๊ทธ๋ฆฌ๊ณ  MyDart MCP๋งŒ์˜ ํŠน์žฅ์ 

DART๋ฅผ AI์— ๋ถ™์ด๋Š” MCP๋Š” ์ด๋ฏธ ์—ฌ๋Ÿฟ ๋‚˜์™€ ์žˆ์Šต๋‹ˆ๋‹ค. ๋‹ค๋งŒ ๊ธฐ์กด ๋„๊ตฌ๋“ค์€ ๋Œ€์ฒด๋กœ ํˆฌ์ž์ž ์ž…์žฅ์—์„œ ์‚ฌ์šฉํ•˜๊ธฐ ์œ„ํ•œ ๋„๊ตฌ์— ๋งž์ถฐ์ ธ ์žˆ์Šต๋‹ˆ๋‹ค. ์ž„์›์ด ์ž๊ธฐ ๋ˆ์œผ๋กœ ์ฃผ์‹์„ ์‚ฌ๊ณ  ์žˆ๋Š”์ง€, ROE์™€ ๋ถ€์ฑ„๋น„์œจ์ด ๋™์ข…์‚ฌ ๋Œ€๋น„ ์–ด๋–ค์ง€, ์ตœ๊ทผ ์ž๊ธฐ์ฃผ์‹ ์ทจ๋“์„ ๊ฒฐ์ •ํ•œ ํšŒ์‚ฌ๊ฐ€ ์–ด๋””์ธ์ง€ โ€” ์ด๋Ÿฌํ•œ ์งˆ๋ฌธ๋“ค์€ ํˆฌ์ž๋ฅผ ์œ„ํ•ด ์ข…๋ชฉ์„ ๊ณ ๋ฅด๋Š” ์‚ฌ๋žŒ์—๊ฒŒ ํ•„์š”ํ•œ ๊ด€์ ์ž…๋‹ˆ๋‹ค. ๋ฐ˜๋ฉด ๊ฐ์‚ฌ์ธ๊ณผ ์žฌ๋ฌดํšŒ๊ณ„/๋‚ด๋ถ€ํšŒ๊ณ„ ๋‹ด๋‹น์ž๊ฐ€ ๊ถ๊ธˆํ•œ ๋ถ€๋ถ„์€ ์กฐ๊ธˆ ๊ด€์ ์ด ๋‹ค๋ฆ…๋‹ˆ๋‹ค. "์ด ํšŒ์‚ฌ KAM์€ ์–ด๋–ค๊ฒŒ ์‹๋ณ„๋˜์—ˆ์„๊นŒ", "๊ณ„์†๊ธฐ์—… ๋ถˆํ™•์‹ค์„ฑ ๋ฌธ๋‹จ์ด ๋“ค์–ด๊ฐ”๋‚˜", "์˜ฌํ•ด ๋‚ด๋ถ€ํšŒ๊ณ„๊ด€๋ฆฌ์ œ๋„ ๊ฐ์‚ฌ๋ณด๊ณ ์„œ์ƒ ์ค‘์š”ํ•œ ์ทจ์•ฝ์ ์ด ๋ณด๊ณ ๋œ ํšŒ์‚ฌ๊ฐ€ ์–ด๋””์ธ๊ฐ€" ๊ฐ™์€ ๊ฒƒ๋“ค์ด์ฃ .

MyDart MCP๋Š” ํšŒ๊ณ„์‚ฌ ๋ฐ ์žฌ๋ฌดํšŒ๊ณ„/๋‚ด๋ถ€ํšŒ๊ณ„ ์‹ค๋ฌด๋‹ด๋‹น์ž์˜ ์‹ค๋ฌด์— ์‚ฌ์šฉํ•˜๊ธฐ ์œ„ํ•œ ๋„๊ตฌ๋กœ ์„ค๊ณ„๋˜์—ˆ๊ณ , ๋‹ค์Œ๊ณผ ๊ฐ™์€ ์žฅ์ ์ด ์žˆ์Šต๋‹ˆ๋‹ค.

์ฒซ์งธ, ๋กœ์ปฌ ์„ค์น˜ ์—†์ด ์›น์œผ๋กœ ์—ฐ๊ฒฐํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ธฐ์กด MCP๋Š” ๋Œ€๋ถ€๋ถ„ ๋กœ์ปฌ ์‹คํ–‰ ๋ฐฉ์‹์ด๋ผ Node.js๋ฅผ ๊น”๊ณ  claude_desktop_config.json์„ ์ง์ ‘ ํŽธ์ง‘ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ๊ทธ๋Ÿฐ๋ฐ ํšŒ๊ณ„๋ฒ•์ธ์ด๋‚˜ ๊ธฐ์—… ์žฌ๊ฒฝํŒ€ PC๋Š” ์ด๋Ÿฌํ•œ ๊ฐœ๋ฐœ ๋„๊ตฌ ์„ค์น˜ ์ž์ฒด๊ฐ€ ๋ง‰ํ˜€ ์žˆ๋Š” ๊ฒฝ์šฐ๊ฐ€ ๋งŽ์Šต๋‹ˆ๋‹ค. MyDart MCP๋Š” ์›๊ฒฉ ์„œ๋ฒ„๋กœ ๋Œ์•„๊ฐ€์„œ ์ปค๋„ฅํ„ฐ์— ์ฃผ์†Œ๋งŒ ๋„ฃ์œผ๋ฉด ๋์ด๊ณ , ๊ธฐ๋Šฅ์ด ์ถ”๊ฐ€๋ผ๋„ ์‚ฌ์šฉ์ž๊ฐ€ ๋”ฐ๋กœ ์—…๋ฐ์ดํŠธํ•  ๊ฒŒ ์—†์Šต๋‹ˆ๋‹ค. ํŠนํžˆ ํ•œ๋ฒˆ ์—ฐ๊ฒฐํ•˜๋ฉด ๋ฐ์Šคํฌํƒ‘/์›น/๋ชจ๋ฐ”์ผ ํ™˜๊ฒฝ์—์„œ ์–ด๋””๋“  ๋™์ผํ•˜๊ฒŒ MCP๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. (๋ฐ˜๋ฉด ๋กœ์ปฌ ์„ค์น˜๋ฐฉ์‹์€ ๋ฐ์Šคํฌํƒ‘์—์„œ๋งŒ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.)

๋‘˜์งธ, ๊ฐ์‚ฌ๋ณด๊ณ ์„œ๋ฅผ ๋ฌธ๋‹จ ์†์„ฑ๋ณ„๋กœ ์„ธ๋ถ„ํ™”ํ•˜์—ฌ ์กฐํšŒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. Opendart API๋ฅผ ์ด์šฉํ•˜๋ฉด ๊ฐ์‚ฌ๋ณด๊ณ ์„œ๋ฅผ ํ†ต์งธ๋กœ ๋งˆํฌ๋‹ค์šด์œผ๋กœ ๋ฐ›์•„์˜ฌ์ˆ˜ ์žˆ์ง€๋งŒ ๊ฐ์‚ฌ๋ณด๊ณ ์„œ ๋ฌธ๋‹จ๋ณ„ ์†์„ฑ์ด ๊ธฐ์žฌ๋˜์–ด ์žˆ์ง€๋Š” ์•Š์Šต๋‹ˆ๋‹ค. MyDart MCP๋Š” ๊ฐ์‚ฌ์˜๊ฒฌยท์˜๊ฒฌ๊ทผ๊ฑฐยทKAMยท๊ฐ•์กฐ์‚ฌํ•ญยท๊ธฐํƒ€์‚ฌํ•ญ์„ ๊ฐ๊ฐ ๋ณ„๋„ ํ•„๋“œ๋กœ ์ชผ๊ฐœ ๋‘์—ˆ๊ณ , ํšŒ๊ณ„๋ฒ•์ธ๋ณ„๋กœ๋„ ์กฐํšŒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋‚ด๋ถ€ํšŒ๊ณ„๊ด€๋ฆฌ์ œ๋„๋„ ๊ฒ€ํ† ์™€ ๊ฐ์‚ฌ๋ฅผ ๊ตฌ๋ถ„ํ•ด์„œ ๊ฐ์‚ฌ์˜๊ฒฌ๊ณผ ์ค‘์š”ํ•œ ์ทจ์•ฝ์  ๋ฌธ๋‹จ์„ ๋”ฐ๋กœ ์กฐํšŒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์…‹์งธ, ํšŒ์‚ฌ ์ด๋ฆ„์„ ๋ชฐ๋ผ๋„ ์ฐพ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. OpenDART API๋Š” ํšŒ์‚ฌ๋ฅผ ์ง€์ •ํ•ด์•ผ๋งŒ ์กฐํšŒ๊ฐ€ ๋ฉ๋‹ˆ๋‹ค. ๊ทธ๋ž˜์„œ ๊ธฐ์กด MCP๋“ค์€ ์ „๋ถ€ "ํšŒ์‚ฌ๋ช… โ†’ corp_code โ†’ ๋ฐ์ดํ„ฐ" ์ˆœ์„œ๋ฅผ ๋ฒ—์–ด๋‚˜์ง€ ๋ชปํ•ฉ๋‹ˆ๋‹ค. MyDart MCP๋Š” ์ƒ์žฅ์‚ฌ ๊ฐ์‚ฌ๋ณด๊ณ ์„œ๋ฅผ ๋ฏธ๋ฆฌ ํŒŒ์‹ฑํ•ด์„œ ์ธ๋ฑ์‹ฑํ•ด๋‘์—ˆ๊ธฐ ๋•Œ๋ฌธ์— "2025๋…„ ์ฝ”์Šค๋‹ฅ์—์„œ ๋‚ด๋ถ€ํšŒ๊ณ„ ์˜๊ฒฌ๊ฑฐ์ ˆ ๋‚œ ํšŒ์‚ฌ"์ฒ˜๋Ÿผ ํŠน์ • ์กฐ๊ฑด์œผ๋กœ ํšŒ์‚ฌ๋ฅผ ํ•„ํ„ฐ๋งํ•ด์„œ ์ฐพ๋Š” ์งˆ๋ฌธ์ด ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.


ํด๋กœ๋“œ ์›น์—์„œ MCP ์—ฐ๊ฒฐํ•˜๋Š”๋ฒ•

1. OpenDART ์ธ์ฆํ‚ค๋ฅผ ๋ฐœ๊ธ‰๋ฐ›์Šต๋‹ˆ๋‹ค. opendart.fss.or.kr์—์„œ ๋ฌด๋ฃŒ๋กœ ๋ฐ›์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ธ์ฆํ‚ค ์‹ ์ฒญ ๋ฉ”๋‰ด๋กœ ๋“ค์–ด๊ฐ‘๋‹ˆ๋‹ค.

โ€‹์ด๋ฉ”์ผ ๋ฐ ๋น„๋ฐ€๋ฒˆํ˜ธ๋Š” ๋‚˜์ค‘์— API ์‚ฌ์šฉ๋Ÿ‰๋“ฑ ์กฐํšŒํ• ๋•Œ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. API ์‚ฌ์šฉํ™˜๊ฒฝ: ์›น API ์‚ฌ์šฉ์šฉ๋„: DART ์ •๋ณด ํฌ๋กค๋ง ๋“ฑ์œผ๋กœ ์ ๋‹นํžˆ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค.

API key๊ฐ€ ๋ฐœ๊ธ‰๋˜์—ˆ์Šต๋‹ˆ๋‹ค. (๊ฐœ์ธ์€ ์ฆ‰์‹œ ๋ฐœ๊ธ‰ ๊ฐ€๋Šฅ)

  1. claude.ai โ†’ ์„ค์ •(Settings) โ†’ ์ปค๋„ฅํ„ฐ(Connectors)๋กœ ๋“ค์–ด๊ฐ‘๋‹ˆ๋‹ค. "์ปค์Šคํ…€ ์ปค๋„ฅํ„ฐ ์ถ”๊ฐ€" ๋ฒ„ํŠผ์„ ๋ˆ„๋ฅด์„ธ์š”.

"์ปค๋„ฅํ„ฐ"์—์„œ "๋งž์ถค์„ค์ •"์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.

[+] ๋ฒ„ํŠผ ํด๋ฆญํ›„ "์ปค์Šคํ…€ ์ปค๋„ฅํ„ฐ ์ถ”๊ฐ€"๋ฅผ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.

3. ์ด๋ฆ„๊ณผ URL์„ ๋„ฃ์Šต๋‹ˆ๋‹ค.

  • ์ด๋ฆ„์€ ์•„๋ฌด๊ฑฐ๋‚˜ ์ ์–ด๋„ ๋ฉ๋‹ˆ๋‹ค.(์˜ˆ: MyDart MCP),
  • URL์€ ์ด๋ ‡๊ฒŒ ์ ์Šต๋‹ˆ๋‹ค.
https://mydart.eocpa.kr/mcp?key=๋ฐœ๊ธ‰๋ฐ›์€_OpenDART_ํ‚ค

์œ ์˜ํ• ์ ์€ ํด๋กœ๋“œ ์›น ์„ค์ • ํ™”๋ฉด์—๋Š” ์ธ์ฆํ‚ค๋ฅผ ๋”ฐ๋กœ ๋„ฃ๋Š” ์นธ์ด ์—†์–ด์„œ, ์ฃผ์†Œ ๋์˜ ?key= ๋’ค์— ์ธ์ฆํ‚ค๋ฅผ ๊ทธ๋Œ€๋กœ ๋ถ™์—ฌ์•ผ ๋ฉ๋‹ˆ๋‹ค. ์„œ๋ฒ„๊ฐ€ ๊ทธ api ํ‚ค๊ฐ’์„ ์ฝ์–ด opendart์—์„œ ์กฐํšŒ ์ธ์ฆ์„ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.

  • ๊ณ ๊ธ‰์„ค์ • ๋ถ€๋ถ„์€ ๊ณต๋ž€์œผ๋กœ ๋‘ก๋‹ˆ๋‹ค.

4. ์ถ”๊ฐ€ํ•˜๋ฉด ๋์ž…๋‹ˆ๋‹ค. ๋Œ€ํ™”์ฐฝ์—์„œ ํ‰์†Œ์ฒ˜๋Ÿผ ์งˆ๋ฌธํ•˜๋ฉด, ํด๋กœ๋“œ๊ฐ€ ์•Œ์•„์„œ ์ด MyDart MCP์˜ ๋„๊ตฌ์„ค๋ช…์„ ์ฝ๊ณ  ํ•„์š”ํ•œ ๊ฒฝ์šฐ ์ž๋™์œผ๋กœ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค.

  • ํ˜„์žฌ๊นŒ์ง€๋Š” ํด๋กœ๋“œ ์›น/๋ฐ์Šคํฌํƒ‘ ํ™˜๊ฒฝ๋งŒ ์ง€์›ํ•˜๋ฉฐ, CLI ํ™˜๊ฒฝ์—์„œ์˜ ์—ฐ๊ฒฐ์€ ์ง€์›ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

ํ™œ์šฉ ์‚ฌ๋ก€

MyDART MCP๋ฅผ ํ†ตํ•ด ํ‰์†Œ DART๋ฅผ ์ง์ ‘ ์กฐํšŒํ•ด์•ผ ํ–ˆ๋˜ ๊ฒƒ์„ ํด๋กœ๋“œ๋ฅผ ํ†ตํ•ด ๋ง๋กœ ์‹œํ‚ฌ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

Dart ๊ธฐ์—…๊ฐœํ™ฉ ์กฐํšŒ(get_company_profile)

๐Ÿ’ก

Dart์—์„œ ์ œ๊ณตํ•˜๋Š” ๊ธฐ์—…๊ฐœํ™ฉ ์ •๋ณด๋ฅผ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.

"ํ˜„๋Œ€์ฐจ ๊ธฐ์—…๊ฐœํ™ฉ ์ •๋ฆฌํ•ด์ค˜ โ€” ๋Œ€ํ‘œ์ž, ์„ค๋ฆฝ์ผ, ์—…์ข…, ๋ณธ์‚ฌ ์ฃผ์†Œ"

Dart ๊ณต์‹œ ๋ชฉ๋ก ์กฐํšŒ(search_disclosures)

๐Ÿ’ก

๊ธฐ๊ฐ„๋ณ„ ๊ณต์‹œ ๋ชฉ๋ก์„ ์กฐํšŒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

"์ตœ๊ทผ ํ•œ ๋‹ฌ๊ฐ„ LG์—๋„ˆ์ง€์†”๋ฃจ์…˜์ด ๋‚ธ ๊ณต์‹œ ๋ชฉ๋ก ๋ณด์—ฌ์ค˜"

์žฌ๋ฌด์ •๋ณด ์กฐํšŒ(get_financials)

๐Ÿ’ก

์žฌ๋ฌด์ •๋ณด๋ฅผ ์กฐํšŒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์žฌ๋ฌด์ œํ‘œ ๋ณธ๋ฌธ(BS, PL) ๋ฟ๋งŒ ์•„๋‹ˆ๋ผ ์ฃผ์„๋ณ„ ๊ฒ€์ƒ‰์ด ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

"๋„ค์ด๋ฒ„์˜ 2025๋…„ ์—ฐ๊ฒฐ ์žฌ๋ฌด์ œํ‘œ์ƒ ์œ ํ˜•์ž์‚ฐ ์ฃผ์„ ์•Œ๋ ค์ค˜"

๊ฐ์‚ฌ์ธ ์ •๋ณด ์กฐํšŒ(get_audit_profile)

๐Ÿ’ก

๋งค ์‚ฌ์—…์—ฐ๋„๋ณ„ ๊ฐ์‚ฌ์ธ๋ช…, ๊ฐ์‚ฌ์˜๊ฒฌ, ๊ฐ์‚ฌ๋ณด์ˆ˜, ๊ฐ์‚ฌ์‹œ๊ฐ„, ๋น„๊ฐ์‚ฌ๋ณด์ˆ˜, ์™ธ๋ถ€์กฐํšŒ/์žฌ๊ณ ์‹ค์‚ฌ/๊ธˆ์œต์‹ค์‚ฌ ์ˆ˜ํ–‰์—ฌ๋ถ€๋ฅผ ์กฐํšŒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

"์‚ผ์„ฑ์ „์ž ์ตœ๊ทผ 5๊ฐœ๋…„ ๊ฐ์‚ฌ์ธ ๋ˆ„๊ตฌ๊ณ , ๊ฐ์‚ฌ๋ณด์ˆ˜ยท๊ฐ์‚ฌ์‹œ๊ฐ„ ์•Œ๋ ค์ค˜"

๊ฐ์‚ฌ๋ณด๊ณ ์„œ ๋ณธ๋ฌธ ๋ฌธ๋‹จ๋ณ„ ์กฐํšŒ(get_audit_report)

๐Ÿ’ก

๊ฐ์‚ฌ๋ณด๊ณ ์„œ ๋ณธ๋ฌธ ๋ฌธ๋‹จ๋ณ„(๊ฐ์‚ฌ์˜๊ฒฌ, ๊ฐ์‚ฌ์˜๊ฒฌ๊ทผ๊ฑฐ, ํ•ต์‹ฌ๊ฐ์‚ฌ์‚ฌํ•ญ, ๊ฐ•์กฐ์‚ฌํ•ญ, ๊ธฐํƒ€์‚ฌํ•ญ ๋“ฑ) ์ •๋ณด๋ฅผ ์กฐํšŒ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

"SKํ•˜์ด๋‹‰์Šค ์ตœ๊ทผ 5๊ฐœ๋…„๊ฐ„ ๋ณ„๋„ ๊ฐ์‚ฌ๋ณด๊ณ ์„œ ์ƒ ํ•ต์‹ฌ๊ฐ์‚ฌ์‚ฌํ•ญ์„ ์ •๋ฆฌํ•ด์ค˜"

๊ณ„์†๊ธฐ์—… ๊ฐ€์ • ๋ถˆํ™•์‹ค์„ฑ ๋ฌธ๋‹จ ๊ฒ€ํ† (get_going_concern)

๐Ÿ’ก

๊ณ„์†๊ธฐ์—… ๊ฐ€์ • ๋ถˆํ™•์‹ค์„ฑ ๋ฌธ๋‹จ์ด ๊ฐ•์กฐ์‚ฌํ•ญ์œผ๋กœ ํฌํ•จ๋˜์—ˆ๋Š”์ง€, ๊ทธ๋ฆฌ๊ณ  ์žฌ๋ฌด์ •๋ณด์™€ ๋น„๊ตํ•˜์—ฌ ๊ณ„์†๊ธฐ์—… ๊ฐ€์ • ๋ถˆํ™•์‹ค์„ฑ๊ณผ ๊ด€๋ จํ•œ ์žฌ๋ฌด์  ์ •๋Ÿ‰ ์ง•ํ›„๊ฐ€ ์žˆ๋Š”์ง€ ์—ฌ๋ถ€๋ฅผ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.

"(์ฃผ)ABC์— ๋Œ€ํ•ด ์ตœ๊ทผ 3๊ฐœ๋…„์— ๋Œ€ํ•ด ๊ณ„์†๊ธฐ์—…๊ฐ€์ • ๋ฌธ๋‹จ์ด ๊ธฐ์žฌ๋˜์—ˆ๋Š”์ง€ ์•Œ๋ ค์ค˜"

๋‚ด๋ถ€ํšŒ๊ณ„๊ด€๋ฆฌ์ œ๋„ ๊ฐ์‚ฌ์˜๊ฒฌ, ์ค‘์š”ํ•œ ์ทจ์•ฝ์  ์กฐํšŒ(get_internal_control)

๐Ÿ’ก

๋‚ด๋ถ€ํšŒ๊ณ„๊ด€๋ฆฌ์ œ๋„ ๊ฐ์‚ฌ์˜๊ฒฌ, ๋ฌธ๋‹จ๋ณ„ ๋‚ด์šฉ์„ ์กฐํšŒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

"(์ฃผ)ABC์˜ 2025๋…„ ๊ฐ์‚ฌ๋ณด๊ณ ์„œ์ƒ ์ค‘์š”ํ•œ ์ทจ์•ฝ์  ๋‚ด์šฉ ์•Œ๋ ค์ค˜"

๊ฐ์‚ฌ๋ณด๊ณ ์„œ ์ฃผ์š” ๋‚ด์—ญ๋ณ„ ์กฐํšŒ(search_audit_findings)

๐Ÿ’ก

์ƒ์žฅ์‚ฌ์˜ ์žฌ๋ฌด์ œํ‘œ/๋‚ด๋ถ€ํšŒ๊ณ„๊ด€๋ฆฌ์ œ๋„ ๊ฐ์‚ฌ๋ณด๊ณ ์„œ ์ฃผ์š” ๋‚ด์—ญ์ด ์ธ๋ฑ์‹ฑ ๋˜์–ด ์žˆ์–ด, ํŠน์ • ํšŒ์‚ฌ ์ด๋ฆ„์„ ๋ชฐ๋ผ๋„ ๊ฒ€์ƒ‰์ด ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

"์˜ฌํ•ด ์ฝ”์Šค๋‹ฅ ์‹œ์žฅ์—์„œ ๋‚ด๋ถ€ํšŒ๊ณ„๊ด€๋ฆฌ์ œ๋„ ์˜๊ฒฌ์ด ๋ถ€์ ์ •์ธ ํšŒ์‚ฌ ์•Œ๋ ค์ค˜"

Ref

1. ๋ณธ ํ”„๋กœ์ ํŠธ ๋ผ์ด์„ ์Šค

  • MIT License
  • ๋‹จ, ์•„๋ž˜ ยง2 ์˜ Apache-2.0 ๋ผ์ด์„ ์Šค ๋ถ€๋ถ„์€ Apache-2.0๋ฅผ ํ•จ๊ป˜ ์ค€์ˆ˜ํ•ฉ๋‹ˆ๋‹ค.

2. ์ฐธ๊ณ ํ•œ ์ž๋ฃŒ

  • kreports-dart-mcp(by capitalparser) : Apache-2.0
  • korean-dart-mcp(by Chris Ryu) : MIT
  • OpenDartReader(by Finance Data) : MIT
  • dart-fss(by josw123) : MIT

3. ๋ฐ์ดํ„ฐ ์ถœ์ฒ˜

  • ๊ธˆ์œต๊ฐ๋…์› OpenDART (https://opendart.fss.or.kr) โ€” ์ „์ž๊ณต์‹œ ์›๋ฌธยท์ •ํ˜• ๋ฐ์ดํ„ฐ.
    • ๋ณธ ์†Œํ”„ํŠธ์›จ์–ด๋Š” ๋ฐ์ดํ„ฐ๋ฅผ ์žฌ๋ฐฐํฌํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์‚ฌ์šฉ์ž๊ฐ€ ๋ณธ์ธ์ด ๋ฐœ๊ธ‰๋ฐ›์€ API ์ธ์ฆํ‚ค๋กœ OpenDART API ๋ฅผ ์ง์ ‘ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค.
    • ๋ฐ์ดํ„ฐ์˜ ์ด์šฉ์€ OpenDART ์ด์šฉ์•ฝ๊ด€ ๋ฐ ๊ด€๋ จ ๋ฒ•๊ทœ๋ฅผ ๋”ฐ๋ผ์•ผ ํ•ฉ๋‹ˆ๋‹ค.
    • OpenDART API FAQ: ์˜คํ”ˆAPI ์ด์šฉํ•œ๋„๋Š” ์–ด๋–ป๊ฒŒ ๋˜๋‚˜์š”? -> ๊ฐœ์ธ : ์ผ 40,000๊ฑด (์„œ๋น„์Šค๋ณ„ ํ•œ๋„๊ฐ€ ์•„๋‹Œ ์˜คํ”ˆAPI 83์ข… ์ „์ฒด ์„œ๋น„์Šค ๊ธฐ์ค€), ์ผ์ผํ•œ๋„๋ฅผ ์ค€์ˆ˜ํ•˜๋”๋ผ๋„ ์„œ๋น„์Šค์˜ ์•ˆ์ •์ ์ธ ์šด์˜์„ ์œ„ํ•˜์—ฌ ๊ณผ๋„ํ•œ ๋„คํŠธ์›Œํฌ ์ ‘์†(๋ถ„๋‹น 1,000ํšŒ ์ด์ƒ)์€ ์„œ๋น„์Šค ์ด์šฉ์ด ์ œํ•œ๋  ์ˆ˜ ์žˆ์œผ๋‹ˆ ์ด์šฉ์— ์ฐธ๊ณ ํ•˜์‹œ๊ธฐ ๋ฐ”๋ž๋‹ˆ๋‹ค.

4. ๋ฉด์ฑ…

๋ณธ ๋„๊ตฌ์˜ DBยทํŒŒ์‹ฑยท๋ถ„๋ฅ˜ยทํ”Œ๋ž˜๊ทธ(๊ฐ์‚ฌ์˜๊ฒฌยทKAMยท๊ณ„์†๊ธฐ์—…ยท๋‚ด๋ถ€ํšŒ๊ณ„ ์ทจ์•ฝ์  ๋“ฑ)๋Š” OpenDART API ๋“ฑ์„ ํ†ตํ•œ ์ž๋™ ์ถ”์ถœ ๊ฒฐ๊ณผ์ด๋ฉฐ, ๊ฐ์‚ฌ ํŒ๋‹จยท์˜์‚ฌ๊ฒฐ์ •์˜ ๊ทผ๊ฑฐ๋กœ ์“ฐ๊ธฐ ์ „ ์›๋ฌธ๊ณผ ๊ต์ฐจ ํ™•์ธํ•˜์‹œ๊ธฐ ๋ฐ”๋ž๋‹ˆ๋‹ค.

5. ๋ฌธ์˜

๊ธฐ๋Šฅ๊ณผ ๊ด€๋ จํ•˜์—ฌ ๋ฌธ์˜์‚ฌํ•ญ์ด ์žˆ์œผ์‹œ๋ฉด ์ด ํฌ์ŠคํŠธ์˜ ๋Œ“๊ธ€๋กœ ๋‚จ๊ฒจ์ฃผ์‹œ๋ฉด ๊ฐ์‚ฌํ•˜๊ฒ ์Šต๋‹ˆ๋‹ค.

๋‚ด๋ถ€ํšŒ๊ณ„๊ด€๋ฆฌ์ œ๋„ ์—…๋ฌด์— MCP๋ฅผ ๋ถ™์ด๋ฉด ๋ฌด์—‡์ด ๋‹ฌ๋ผ์งˆ๊นŒ์š”. ์ค‘์š”ํ•œ ์ทจ์•ฝ์  ์‚ฌ๋ก€ ์ง‘๊ณ„, ์ž๊ธˆ๋ถ€์ •ํ†ต์ œ ๊ณต์‹œ ์กฐํšŒ, ํ‰๊ฐ€๋ณด๊ณ ์„œ MRC ๊ฒ€์ฆ, ๋‚ด๋ถ€ํšŒ๊ณ„ ์ค€๊ฑฐ๊ทœ์ • ํ™•์ธ๊นŒ์ง€ ์‹ค์ œ ํ”„๋กฌํ”„ํŠธ์™€ ํ•จ๊ป˜ ์ •๋ฆฌํ–ˆ์Šต๋‹ˆ๋‹ค.

์ƒ์žฅ์‚ฌ ๊ฐ์‚ฌ๋ณด๊ณ ์„œ๋ฅผ ํ•œ๋ˆˆ์— ์กฐํšŒํ•  ์ˆ˜ ์žˆ๋Š” MyDart Viewer๋ฅผ ์†Œ๊ฐœํ•ฉ๋‹ˆ๋‹ค.

๋งค์ผ ๋”ฐ๋กœ ๊ฒ€์ƒ‰ํ•˜์ง€ ์•Š์•„๋„ ์›ํ•˜๋Š” ์‹œ๊ฐ„์— ์‚ฌ์ „ ์„ค์ •ํ•œ ๋‚ด๋ถ€ํšŒ๊ณ„ยทํšŒ๊ณ„๊ฐ๋…ยทํšŒ์‚ฌ ํ‚ค์›Œ๋“œ์™€ ๊ด€๋ จํ•œ ๋‰ด์Šค, Dart ๊ณต์‹œ๋ฅผ ๋ฉ”์ผ๋กœ ๋ฐ›์•„๋ณผ ์ˆ˜ ์žˆ๋Š” ๋‰ด์Šค๋ด‡์„ ๋งŒ๋“ค์—ˆ์Šต๋‹ˆ๋‹ค.