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

🤝 기여

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

📞 지원

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