M MCP모아
가이드

한국 주식 AI 분석 MCP — Claude로 종목 분석 리포트 자동 생성하기

한국 주식 AI 분석 MCP를 Claude에 연결해 DART·KRX 데이터를 기반으로 종목 분석 리포트를 자동 생성하는 방법을 완전히 정리했습니다. AI 투자 분석 MCP 서버 3종 비교 포함.

Claude AI가 DART와 KRX 데이터를 기반으로 한국 주식 종목 분석 리포트를 자동 생성하는 흐름을 보여주는 표지 이미지

Claude에 한국 주식 MCP 서버를 연결하면 DART(전자공시시스템)와 KRX 데이터를 자연어로 질의해 종목 분석 리포트를 자동 생성할 수 있습니다. 복잡한 API 호출 없이 “삼성전자의 최근 4분기 영업이익 추이를 분석해 줘”처럼 대화하면 됩니다. 이 글에서는 현재 한국 주식 AI 분석에 쓸 수 있는 MCP 서버 3종의 특징, 설치 방법, 실전 활용 팁을 구체적으로 설명합니다.

왜 한국 주식 분석에 MCP가 필요한가

기존 방식으로 국내 상장사 재무 데이터를 분석하려면 DART OpenAPI 문서를 읽고, 파이썬 또는 자바스크립트로 API를 호출하고, 응답 JSON을 파싱해 정리하는 과정이 필요했습니다. 투자자가 직접 코딩을 해야 하거나, 별도의 분석 툴을 구매해야 했습니다.

MCP(Model Context Protocol) 는 이 과정을 AI와 데이터 소스 사이의 표준 인터페이스로 단순화합니다. Claude가 MCP 서버를 통해 DART·KRX API를 직접 호출하고, 그 결과를 사람이 읽기 좋은 분석 리포트 형태로 정리해 줍니다. 코드 한 줄 작성 없이 재무제표, 공시 내용, 시세 데이터를 AI와 함께 분석할 수 있는 것입니다.

[사용자 질의]
    ↓ 자연어
[Claude (AI)]
    ↓ MCP 프로토콜
[한국 주식 MCP 서버]
    ↓ REST API 호출
[DART OpenAPI / KRX]
    ↓ JSON 응답
[MCP 서버 → 구조화 데이터]
    ↓ 분석 결과
[Claude → 종목 분석 리포트]

한국 주식 AI 분석 MCP 서버 3종 비교

현재 MCP모아 금융 카테고리에 등록된 한국 주식 관련 서버 중 실사용이 가능한 3종을 비교합니다.

서버 이름지원 API설치 방식DART 키 필요특징
한국 주식 MCP 서버DART + KRXnpx예시세·재무 통합
DART MCP 서버DART 전자공시uvx(Python)예공시 문서 특화
한국 DART MCPOpenDART 83개 APInpx예15개 도구로 압축

세 서버 모두 DART API 키가 필요합니다. 키는 opendart.fss.or.kr에서 무료로 발급받을 수 있습니다.

DART API 키 발급 방법

  1. OpenDART 공식 사이트에 접속합니다.
  2. 회원가입 후 로그인합니다.
  3. 상단 메뉴에서 인증키 신청/관리를 선택합니다.
  4. 이용 목적을 선택하고 신청하면 즉시 API 키가 발급됩니다.
  5. 발급된 키를 안전한 곳에 복사해 둡니다.

서버별 설치 및 Claude 연동 방법

1. 한국 주식 MCP 서버 (Korea Stock MCP)

DART와 KRX를 함께 지원하는 통합형 서버입니다. Node.js 환경에서 npx로 실행합니다.

Claude Desktop 설정 파일 경로

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "korea-stock-mcp": {
      "command": "npx",
      "args": ["-y", "korea-stock-mcp@latest"],
      "env": {
        "DART_API_KEY": "여기에_발급받은_API_키_입력"
      }
    }
  }
}

GitHub 저장소: https://github.com/jjlabsio/korea-stock-mcp

2. DART MCP 서버

Python 기반 서버로, DART 전자공시 데이터를 깊이 있게 분석할 때 유용합니다. uv 패키지 매니저가 필요합니다.

먼저 저장소를 로컬에 내려받습니다.

git clone https://github.com/2geonhyup/dart-mcp.git ~/Downloads/dart-mcp

Claude Desktop 설정에 아래와 같이 추가합니다.

{
  "mcpServers": {
    "dart-mcp": {
      "command": "uv",
      "args": ["--directory", "~/Downloads/dart-mcp", "run", "dart.py"],
      "env": {
        "DART_API_KEY": "여기에_발급받은_API_키_입력"
      }
    }
  }
}

GitHub 저장소: https://github.com/2geonhyup/dart-mcp

3. 한국 DART MCP (Korean DART MCP)

OpenDART의 83개 API를 15개의 MCP 도구로 정리한 서버입니다. 설치가 가장 간단합니다.

{
  "mcpServers": {
    "korean-dart-mcp": {
      "command": "npx",
      "args": ["-y", "korean-dart-mcp"],
      "env": {
        "DART_API_KEY": "여기에_발급받은_API_키_입력"
      }
    }
  }
}

GitHub 저장소: https://github.com/chrisryugj/korean-dart-mcp

Claude Code에서 사용하는 방법

Claude Desktop 대신 Claude Code(CLI 환경)를 사용한다면 아래 명령으로 MCP 서버를 등록할 수 있습니다.

# Korea Stock MCP 등록 예시
claude mcp add korea-stock-mcp \
  --command npx \
  --args "-y,korea-stock-mcp@latest" \
  --env DART_API_KEY=발급받은_키

등록 후 claude mcp list로 서버가 정상 등록됐는지 확인합니다.

실전 활용: 종목 분석 리포트 프롬프트 예시

MCP 서버 연결 후 Claude에게 아래와 같이 요청해 보세요.

재무 비교 분석

삼성전자(005930)와 SK하이닉스(000660)의 최근 연간 재무제표를 비교해 줘.
매출액, 영업이익, 순이익, 부채비율을 표로 정리하고 투자 포인트를 요약해 줘.

공시 모니터링

카카오(035720)의 최근 3개월 주요 공시를 가져와서
투자자에게 중요한 내용 위주로 요약해 줘.

섹터 분석

코스피 반도체 관련 상위 5개 종목의 PER, PBR, 배당수익률을 비교표로 만들어 줘.

흔한 오류와 해결 방법

오류: “DART_API_KEY is not set” 또는 인증 실패

환경 변수가 제대로 전달되지 않은 경우입니다. JSON 설정 파일에서 env 블록을 확인하고, API 키 값에 공백이나 따옴표가 잘못 들어가지 않았는지 점검하세요.

오류: npx 실행 후 서버가 응답하지 않음

Node.js 버전이 낮으면 문제가 발생할 수 있습니다. node --version으로 버전을 확인하고, v18 이상을 권장합니다.

오류: uv 명령을 찾을 수 없음

DART MCP 서버(Python 기반)를 쓸 때 uv가 설치되어 있지 않은 경우입니다. https://docs.astral.sh/uv 공식 문서를 참고해 uv를 먼저 설치하세요.

오류: Claude Desktop 재시작 후 서버 없음

JSON 설정 파일에 문법 오류(콤마 누락, 괄호 불일치)가 있으면 서버 목록이 사라집니다. JSON 검증 도구로 파일을 한 번 확인해 보세요.

어떤 서버를 선택해야 할까

상황추천 서버
재무제표 + 시세 데이터를 함께 분석하고 싶다한국 주식 MCP 서버 (Korea Stock MCP)
공시 원문 분석, 사업보고서 읽기가 주 목적이다DART MCP 또는 한국 DART MCP
Python보다 Node.js 환경이 편하다한국 주식 MCP 또는 한국 DART MCP
OpenDART의 다양한 API를 폭넓게 쓰고 싶다한국 DART MCP (83개 API 지원)

다음 단계

한국 주식 AI 분석 MCP의 기본 설정을 마쳤다면, 금융 카테고리의 다른 MCP 서버들도 함께 살펴보세요. ECOS(한국은행 경제통계), 나라장터, 건강보험 데이터 등 다양한 공공 데이터를 Claude에 연결하는 서버들이 준비되어 있습니다. 새로운 한국 MCP 서버를 발견했다면 전체 서버 목록을 확인하거나, 직접 서버를 등록해 커뮤니티에 기여할 수 있습니다.

자주 묻는 질문

DART API 키 없이도 한국 주식 MCP를 사용할 수 있나요?

현재 소개된 세 서버 모두 DART API 키가 필요합니다. OpenDART에서 무료로 발급받을 수 있으며, 발급 즉시 사용 가능합니다.

Claude Desktop과 Claude Code 중 어디에서 쓰나요?

두 환경 모두 지원합니다. Claude Desktop은 claude_desktop_config.json, Claude Code는 .mcp.json 또는 claude mcp add 명령으로 서버를 등록합니다.

Korea Stock MCP와 DART MCP의 차이는 무엇인가요?

Korea Stock MCP는 DART와 KRX 두 가지 공식 API를 함께 지원해 시세·재무 데이터를 통합 조회할 수 있습니다. DART MCP 계열 서버들은 전자공시 중심으로 재무제표·공시 문서 분석에 특화되어 있습니다.

AI가 생성한 주식 분석 리포트를 투자 결정에 바로 써도 되나요?

AI 분석은 데이터 정리와 초안 작성을 돕는 보조 도구입니다. 최종 투자 결정은 반드시 본인의 판단과 책임 하에 이루어져야 하며, AI 리포트를 유일한 근거로 삼지 마세요.

npx 설치 시 매번 최신 버전이 내려받아지나요?

npx -y 플래그와 @latest 태그를 사용하면 실행 시점의 최신 버전이 자동으로 사용됩니다. 버전을 고정하려면 @latest 대신 @1.0.0처럼 명시하세요.

uvx(uv) 방식은 무엇이 다른가요?

uv는 Python 생태계의 패키지 실행 도구입니다. DART-MCP 서버는 Python으로 작성되어 있어 uv 명령을 사용합니다. Node.js 기반 서버는 npx, Python 기반 서버는 uv를 씁니다.

이 글과 관련된 MCP 서버