프로젝트 소개

이 프로젝트는 한국 금융감독원의 전자공시시스템(DART)이 제공하는 데이터를 대규모 언어 모델(LLM)이 Model Context Protocol(MCP)을 통해 활용할 수 있도록 지원하는 서버 애플리케이션입니다. 이 서버를 통해 LLM은 상장 기업의 공시 정보, 재무 데이터 등에 접근하여 사용자의 질문에 답변하거나 분석을 수행할 수 있습니다.

주요 기능

• 공시 정보 검색: 특정 기업의 기간별 공시 목록을 검색할 수 있습니다.
• 기업 개황 정보 조회: 기업의 기본 정보(주소, 대표자, 업종 등)를 조회할 수 있습니다.
• 기업 고유번호 검색: 기업 이름으로 DART 시스템 내에서 사용되는 고유번호를 검색하고, 이름이 정확하지 않을 경우 유사 기업 후보를 찾을 수 있습니다.
• 증자/감자 현황 조회: 기업의 자본 변동에 관한 공시 내용을 확인할 수 있습니다.
• 향후 기능 확장: 배당, 자기주식, 최대주주 현황 등 DART API가 제공하는 다양한 금융 및 기업 정보 조회 기능이 추가될 예정입니다.

설치 방법

1. 먼저 Python 3 환경과 'uv' 패키지 관리자가 시스템에 설치되어 있어야 합니다.
2. GitHub에서 프로젝트 코드를 다운로드합니다.

   git clone https://github.com/snaiws/DART-mcp-server.git
   

3. 프로젝트 디렉토리로 이동합니다.

   cd DART-mcp-server/dart
   

4. 'uv'를 사용하여 필요한 라이브러리를 설치합니다.

   uv sync
   

5. 금융감독원 전자공시시스템(DART) 홈페이지에서 API 활용 신청을 통해 API 키를 발급받아야 합니다.

MCP 클라이언트 설정 (예: Claude Desktop)

DART-MCP-서버는 MCP 클라이언트와 통신하므로, 클라이언트 애플리케이션에서 이 서버를 인식하도록 설정해야 합니다. Claude Desktop을 예로 들면, 설정 파일('settings.json')의 'mcpServers' 섹션에 다음과 유사하게 서버 정보를 추가합니다.

• 서버 이름: "DART"와 같이 클라이언트가 인식할 고유한 이름을 지정합니다.
• 'command': 서버를 실행할 명령어(예: 'uv')를 지정합니다.
• 'args': 명령어에 전달할 인자 목록을 지정합니다. 여기에는 서버 코드가 위치한 디렉토리 경로와 실행할 Python 스크립트 파일명('mcp_server.py') 등이 포함됩니다. '--directory' 다음에 오는 경로는 사용자의 실제 설치 경로로 변경해야 합니다.

설정 파일을 저장한 후 MCP 클라이언트 앱을 완전히 종료했다가 다시 시작하면 DART-MCP-서버가 클라이언트에 등록되고 활성화됩니다.

중요: DART API 키는 LLM과의 대화 중에 모델이 요청할 때 대화창에 직접 입력해야 합니다.

기본 사용 방법

MCP 클라이언트(예: Claude Desktop)가 DART-MCP-서버를 성공적으로 로드하면, 채팅 입력창 하단 등에 DART 서버에서 제공하는 도구 목록을 확인하는 아이콘이 표시됩니다.

LLM과의 대화에서 한국 기업의 공시나 재무 정보가 필요할 때 자연어로 질문하면, LLM이 DART 서버의 도구를 사용하여 정보를 조회하고 응답을 생성합니다.

예시 질문:

• "삼성전자 최근 공시 중에 사업보고서 찾아줘"
• "네이버 기업 개황 정보 보여줘"
• "카카오의 2023년 증자 현황 분석해줘"
• "하이닉스 고유번호가 뭐야?"
• "SK텔레콤이랑 비슷한 기업들 좀 찾아줘"