Johnhyeon

Dartlens MCP — Development skill for Claude Code

Development community

Claude MCP server for Korean DART filings, financial statements, ownership disclosures, and insider trades.

How to install Dartlens MCP

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Johnhyeon/dartlens-mcp and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Dartlens MCP does

Claude MCP server for Korean DART filings, financial statements, ownership disclosures, and insider trades.

Alternatives in Development

Mempalace Init — Set up MemPalace — install the package, initialize a palace, register the MCP server with Cursor, and verify e 58.6k ★
Value Prop Statements — Generate value prop statements for marketing, sales, and onboarding 7.8k ★
Claude Context Mode — An MCP server that sits between Claude Code and these outputs 5.3k ★

README

dartlens

**전자공시(DART)를 Claude가 진짜 데이터로 읽습니다**

[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

배포 상태

DartLens의 공개 설치 안내는 2026-06-01 기준으로 종료했습니다.

현재 신규 설치는 구매자 안내문을 통해 제공되는 설치 명령어와 가이드를 기준으로 진행합니다. 이미 설치한 기존 사용자는 보유한 공개 버전을 계속 사용할 수 있지만, 신규 배포·설치 지원·활용 템플릿은 구매자 패키지 기준으로 정리합니다.

왜 필요한가

AI에게 공시 PDF를 보여주면 **숫자를 추측해서 틀린 답**을 합니다 — 매출, 영업이익, 지분율, 보고일자가 죄다 환각.

**dartlens**는 Claude에 금융감독원 [DART OpenAPI](https://opendart.fss.or.kr)를 직접 연결해서, AI가 추측이 아닌 **공시 원문·정형 재무제표**를 읽고 분석하도록 만듭니다.

❌ "삼성전자 작년 영업이익 35조쯤이었던 것 같아요" (추측, 틀림)
✅ "삼성전자 2024 사업보고서 영업이익 32.7조원, 전년 6.6조 대비 +395%" (DART 원본)

"삼성전자 최근 분기보고서 요약해줘" · "카카오 최근 1개월 공시 목록" · "LG에너지솔루션 영업이익 추이" · "삼성전자 5% 이상 보유한 주주 변동" · "현대차 임원들 자사주 매매 보여줘"

자매 프로젝트 [stocklens-mcp](https://github.com/Johnhyeon/stocklens-mcp)(네이버 증권 기반 시세·차트·수급)와 **독립**입니다. Claude가 두 MCP를 조합해 종목 분석을 수행합니다.

주요 기능

📑 7개 도구 — 기업 검색, 공시 목록·본문, 재무제표(요약·전체), 5%룰, 임원·주요주주 매매
🔐 API 키는 OS 키체인 (Windows DPAPI / macOS Keychain / Linux Secret Service) — config 평문 저장 X
💸 DART OpenAPI — 분당 1,000건 / 일 20,000건
🧠 토큰 다이어트 — 단위 압축 + 보고서 인덱스 + 키워드 매치 (find=...)로 긴 사업보고서도 가벼움
🩺 dartlens-doctor — 막혔을 때 원인·해결 명령까지 자동 진단

설치 안내

구매자에게 제공되는 안내문에는 다음 과정이 포함됩니다.

uv 확인 및 설치
DartLens MCP 설치
DART API 키 입력 및 검증
Claude Desktop 또는 Claude Code MCP 설정 자동 등록
설치 진단과 첫 실행 확인

공개 README에는 더 이상 직접 설치 명령어를 게시하지 않습니다.

동작 확인

Claude에서:

삼성전자 최근 공시 보여줘

기업명, 공시 목록, 보고일자가 나오면 설치 완료입니다.

설치 문제 진단

dartlens-doctor

uv·패키지·명령·config·API 키 5단계 자동 점검. 문제 원인과 고치는 명령어까지 표시. 친구분이 막혔을 때 이 한 줄만 보내주세요.

키 보관 정책

`dartlens-setup`은 **DART API 키를 `claude_desktop_config.json`에 평문으로 박지 않습니다.**

기본: 키를 OS 키체인에 저장
- Windows → Credential Manager (DPAPI · 사용자 계정 단위 자동 암호화)
- macOS → Keychain
- Linux → Secret Service (GNOME Keyring / KDE Wallet)
config 파일에는 mcpServers.dartlens.command 만 들어가고 키는 들어가지