
dart-mcp
dart-mcp
Tools
search_disclosure
회사의 주요 재무 정보를 검색하여 제공하는 도구. requested_items가 주어지면 해당 항목 관련 데이터가 있는 공시만 필터링합니다. Args: company_name: 회사명 (예: 삼성전자, 네이버 등) start_date: 시작일 (YYYYMMDD 형식, 예: 20230101) end_date: 종료일 (YYYYMMDD 형식, 예: 20231231) ctx: MCP Context 객체 requested_items: 사용자가 요청한 재무 항목 이름 리스트 (예: ["매출액", "영업이익"]). None이면 모든 주요 항목을 대상으로 함. 사용 가능한 항목: 매출액, 영업이익, 당기순이익, 영업활동 현금흐름, 투자활동 현금흐름, 재무활동 현금흐름, 자산총계, 부채총계, 자본총계 Returns: 검색된 각 공시의 주요 재무 정보 요약 텍스트 (요청 항목 관련 데이터가 있는 경우만)
search_detailed_financial_data
회사의 세부적인 재무 정보를 제공하는 도구. XBRL 파일을 파싱하여 상세한 재무 데이터를 추출합니다. Args: company_name: 회사명 (예: 삼성전자, 네이버 등) start_date: 시작일 (YYYYMMDD 형식, 예: 20230101) end_date: 종료일 (YYYYMMDD 형식, 예: 20231231) ctx: MCP Context 객체 statement_type: 재무제표 유형 ("재무상태표", "손익계산서", "현금흐름표" 중 하나 또는 None) None인 경우 모든 유형의 재무제표 정보를 반환합니다. Returns: 선택한 재무제표 유형(들)의 세부 항목 정보가 포함된 텍스트
search_business_information
회사의 사업 관련 현황 정보를 제공하는 도구 Args: company_name: 회사명 (예: 삼성전자, 네이버 등) start_date: 시작일 (YYYYMMDD 형식, 예: 20230101) end_date: 종료일 (YYYYMMDD 형식, 예: 20231231) information_type: 조회할 정보 유형 '사업의 개요' - 회사의 전반적인 사업 내용 '주요 제품 및 서비스' - 회사의 주요 제품과 서비스 정보 '원재료 및 생산설비' - 원재료 조달 및 생산 설비 현황 '매출 및 수주상황' - 매출과 수주 현황 정보 '위험관리 및 파생거래' - 리스크 관리 방안 및 파생상품 거래 정보 '주요계약 및 연구개발활동' - 주요 계약 현황 및 R&D 활동 '기타 참고사항' - 기타 사업 관련 참고 정보 ctx: MCP Context 객체 Returns: 요청한 정보 유형에 대한 해당 회사의 사업 정보 텍스트
get_current_date
현재 날짜를 YYYYMMDD 형식으로 반환하는 도구 Args: ctx: MCP Context 객체 (선택 사항) Returns: YYYYMMDD 형식의 현재 날짜 문자열
search_json_financial_data
회사의 재무 정보를 JSON API를 통해 제공하는 실패시 보완하는 보조 도구. search_disclosure, search_detailed_financial_data이 2023년 9월 이전 자료 분석에 실패했을 때 대안으로 활용. Args: company_name: 회사명 (예: 삼성전자, 네이버 등) bsns_year: 사업연도 (4자리, 예: "2023") ctx: MCP Context 객체 reprt_code: 보고서 코드 ("11011": 사업보고서, "11012": 반기보고서, "11013": 1분기보고서, "11014": 3분기보고서) fs_div: 개별/연결구분 ("OFS": 재무제표, "CFS": 연결재무제표) statement_type: 재무제표 유형 ("BS": 재무상태표, "IS": 손익계산서, "CIS": 포괄손익계산서, "CF": 현금흐름표, "SCE": 자본변동표) None인 경우 모든 유형의 재무제표 정보를 반환합니다. Returns: 선택한 재무제표 유형(들)의 세부 항목 정보가 포함된 텍스트 (당기 데이터만 표시)
README
DART-MCP: 재무 분석을 위한 Claude 확장 프로그램
DART API를 활용한 재무 분석 MCP(Model-assisted Capability Package)입니다. Claude를 이용하여 상장 기업의 재무 데이터를 쉽게 분석하고 시각화할 수 있습니다.
상단에 더 상세하고 쉬운 가이드는 https://dart-mcp.vercel.app/ 에서 보는 걸 추가드립니다.
<a href="https://glama.ai/mcp/servers/@2geonhyup/dart-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@2geonhyup/dart-mcp/badge" alt="dart-mcp MCP server" /> </a>
가능한 것 / 불가능한 것
가능한 것 (O)
- 주요 재무 분석
- 상세 재무 분석
- 기업의 사업부별 매출
- 클로드를 이용한 시각화
- 재무지표를 활용한 벨류에이션 (DCF 등)
불가능한 것 (X)
- 주가 및 시가총액 제공
- 해외기업 분석
- 클로드 무료 사용량 이상의 사용
- 한 채팅창에서 다량 사용 (잘 안되면 채팅창 새로 만들어서 쓰기)
- 100% 정확한 정보
제공하는 투자 정보는 실제와 다를 수 있고 투자 책임은 투자한 본인에게 있습니다.
사용 예시
재무 데이터 분석 및 시각화
파마리서치의 2023, 2024년 매출액, 영업이익 추이 분기별로 그래프로 보여줘. 그리고 매출비중이 어떻게 되는지 알려줘. 영업이익이나 매출액 변동 이유도 분석해줘.
기업 비교 분석
카카오와 네이버 2024년 수익성지표를 비교해서 분기별로 보여주고, 각 기업들은 어떤 사업부가 성장을 이끌지 알려줘.
재무 위험 평가
한국전력의 최근 부채상황을 조사하고, 상세하게 어떤 부분이 문제인지 분석해줘.
사전 준비
DART API 키 발급
- DART 오픈API 웹사이트에 접속
- 회원가입 및 로그인
- [인증키 신청/관리] - [오픈API 이용 신청] 메뉴 클릭
- 이용정보 입력 후 신청
- [인증키 신청/관리] - [오픈API 이용현황] 메뉴에서 발급된 인증키 확인
Claude 데스크톱 앱 설치
- Claude 데스크톱 앱 다운로드
- 계정 가입 및 로그인
설치 방법
1. GitHub에서 프로젝트 다운로드
GitHub 페이지에서 zip 파일을 다운로드합니다. https://github.com/2geonhyup/dart-mcp
2. ZIP 파일 압축 해제 및 폴더 위치 확인
- 다운로드한 ZIP 파일의 압축을 해제합니다.
- 압축 해제 폴더가 Downloads에 있는지 확인합니다. 다른 위치에 있다면 Downloads 위치로 옮겨주세요.
3. 폴더 이름 변경
압축 해제한 폴더 dart-mcp-main 이름을 dart-mcp로 반드시 바꿔주세요. (처음부터 dart-mcp라면 바꾸지 마세요)
4. Claude 앱 접속 및 설정 접근
- 설치한 Claude 데스크톱 앱을 실행합니다.
- 맥 사용자: Claude > 설정 > 개발자 > 설정 편집 클릭 윈도우 사용자: 설정 > 개발자 > 설정 편집 클릭
5. 설정 파일 열기
상단 claude_desktop_config 파일을 텍스트 편집기로 엽니다.
6. 설정 코드 입력
-
먼저 알맞은 키와 이름을 입력하세요
- DART API 키: 발급받은 API 키 입력
- 컴퓨터 이름: 컴퓨터 계정 이름 입력 (Mac에서는 Finder 홈 폴더, Windows에서는 C:\사용자 폴더명)
-
다음 코드를 이용하여 설정 파일에 입력
{
"mcpServers": {
"dart-mcp": {
"command": "uv",
"args": ["--directory", "/Users/{컴퓨터이름}/Downloads/dart-mcp", "run", "dart.py"],
"env": {
"DART_API_KEY": "{DART_API_KEY}"
}
}
}
}
7. Claude 재시작 및 사용 시작
설정 파일을 저장하고 Claude 앱을 닫은 후 다시 시작합니다. 이제 Claude에게 질문하면 DART API를 호출하여 답변을 제공합니다.
사용시 주의사항
- 기업명은 공식적으로 상장된 이름으로 제공해야 합니다.
- 코스피, 코스닥 종목만 조사 가능합니다.
- 주가나 시가총액과 같은 실시간 정보들은 앞으로 연동할 계획입니다.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.