DART 재무제표 분석 MCP 서버

DART API를 활용하여 다중 기업의 재무제표 정보를 분석하고 시각화하는 Model Context Protocol (MCP) 서버입니다.

🚀 주요 기능

다중 기업 재무제표 분석: 여러 기업의 재무 데이터를 동시에 분석
재무 지표 시각화: 매출액, 당기순이익, 총자산, ROE, 부채비율 등 다양한 지표 차트 생성
종합 대시보드: 여러 재무 지표를 한 번에 비교할 수 있는 대시보드 생성
실시간 데이터: DART API를 통한 최신 공시 정보 활용

📊 지원하는 재무 지표

매출액: 기업의 총 매출 규모
당기순이익: 순수한 이익 규모
총자산: 기업이 보유한 모든 자산
총자본: 주주가 투자한 자본
부채비율: 재무 건전성 지표
ROE (자기자본이익률): 자본 효율성 지표
순이익률: 수익성 지표

🛠️ 설치 및 실행

1. 의존성 설치

npm install

2. 빌드

npm run build

3. 실행

npm start

또는 개발 모드로 실행:

npm run dev

🔧 사용법

MCP 클라이언트 설정

MCP 클라이언트에서 다음과 같이 설정하세요:

{
  "mcpServers": {
    "dart-financial": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {}
    }
  }
}

사용 가능한 도구

1. 회사 목록 조회

{
  "name": "get_company_list",
  "arguments": {}
}

2. 재무 데이터 분석

{
  "name": "analyze_financial_data",
  "arguments": {
    "corp_codes": ["00334624", "00126380"],
    "year": "2023",
    "report_code": "11011"
  }
}

3. 특정 지표 차트 생성

{
  "name": "generate_financial_chart",
  "arguments": {
    "corp_codes": ["00334624", "00126380"],
    "year": "2023",
    "report_code": "11011",
    "metric": "revenue"
  }
}

4. 종합 대시보드 생성

{
  "name": "generate_financial_dashboard",
  "arguments": {
    "corp_codes": ["00334624", "00126380"],
    "year": "2023",
    "report_code": "11011"
  }
}

📋 보고서 코드

11011: 사업보고서 (연간)
11012: 반기보고서
11013: 1분기보고서
11014: 3분기보고서

🏢 주요 기업 코드 예시

삼성전자: 00334624
SK하이닉스: 00126380
현대자동차: 00164779
LG에너지솔루션: 00164779
NAVER: 00164779

🔑 API 키 설정

현재 코드에는 DART API 키가 하드코딩되어 있습니다. 실제 운영 환경에서는 환경 변수나 설정 파일을 통해 관리하는 것을 권장합니다.

// src/mcp-server.ts에서 API 키 설정
const apiKey = process.env.DART_API_KEY || 'your-api-key-here';

📈 출력 예시

재무 분석 결과

📊 기업 재무제표 분석 요약

🏆 최고 성과 기업: 삼성전자
📉 최저 성과 기업: NAVER

💰 최고 매출 기업: 삼성전자 (279,604,800,000,000원)

📈 최고 순이익률 기업: SK하이닉스 (15.23%)

📊 상세 분석 결과:

🏢 삼성전자 (2023년)
   📊 매출액: 279,604,800,000,000원
   💰 당기순이익: 15,480,000,000,000원
   🏦 총자산: 426,000,000,000,000원
   📈 총자본: 302,000,000,000,000원
   📊 영업이익: 6,570,000,000,000원

🛡️ 오류 처리

서버는 다음과 같은 오류 상황을 처리합니다:

API 키 오류: 잘못된 DART API 키
데이터 없음: 해당 조건에 맞는 재무 데이터가 없는 경우
네트워크 오류: DART API 서버 연결 실패
잘못된 파라미터: 지원하지 않는 지표나 잘못된 회사 코드

📝 라이선스

MIT License

🤝 기여

버그 리포트나 기능 제안은 이슈를 통해 제출해주세요.

📞 지원

문제가 발생하거나 질문이 있으시면 이슈를 생성해주세요.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

DART API를 활용하여 다중 기업의 재무제표 정보를 분석하고 시각화하는 서버로, 매출액, 당기순이익, 총자산 등 다양한 재무 지표를 차트와 대시보드로 생성합니다.

Related MCP Servers

PageSpeed MCP Server
PhialsBasement
-
security
A
license
-
quality
Acts as a bridge between AI models and Google's PageSpeed Insights API, enabling detailed performance analysis of websites.
Last updated -
419
6
JavaScript
MIT License
MPC Tally API Server
crazyrabbitLTC
A
security
A
license
A
quality
A server that allows AI agents to interact with the Tally API to access DAO governance data, proposals, and metadata using Model Context Protocol (MCP), built with TypeScript and GraphQL.
Last updated -
19
0
6
TypeScript
MIT License
Deriv API MCP Server
raju-deriv
A
security
F
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with the Deriv trading API, providing access to active trading symbols and account balance information.
Last updated -
2
Python
Ledger CLI MCP Server
minhyeoky
A
security
F
license
A
quality
A Model Context Protocol server that allows AI assistants to query and analyze financial data through Ledger CLI, enabling tasks like financial reporting, budget analysis, and accounting.
Last updated -
9
23
Python

View all related MCP servers

DART 재무제표 분석 MCP 서버