한국 주식 MCP 서버 비교 — DART·KRX·pykrx 어떤 걸 써야 할까

Q: Claude Code와 Claude Desktop 중 어디서 쓰는 게 좋나요?

두 클라이언트 모두 MCP 서버를 지원합니다. Claude Code는 터미널 환경에서 /mcp 명령으로 연결 상태를 빠르게 확인할 수 있어 개발자에게 편리합니다. Claude Desktop은 GUI 환경에서 대화형으로 주식 분석을 하려는 투자자에게 적합합니다.

한국 주식 분석을 Claude와 함께 하려면 DART 전자공시, KRX 시세 데이터를 MCP 서버로 연결해야 합니다. 현재 세 가지 오픈소스 MCP 서버가 각각 다른 방식으로 이를 지원하며, 설치 방법·지원 API·사용 목적이 서로 다릅니다. 이 글에서는 세 서버를 실제 설치 명령 기준으로 비교하고, 상황별 최적 선택을 안내합니다.

한국 주식 MCP 서버가 필요한 이유

Claude는 학습 데이터 기준 이후의 주가나 최신 공시 정보를 알지 못합니다. 국내 상장사의 최신 재무제표, 분기 공시, 실시간에 가까운 시세 데이터가 필요하다면 외부 API를 연결해야 합니다.

MCP(Model Context Protocol)는 Claude가 외부 도구를 안전하게 호출할 수 있게 해주는 표준 프로토콜입니다. MCP 서버를 로컬에서 실행하면 Claude가 대화 중에 주식 데이터 API를 직접 호출해 최신 정보를 근거로 분석·답변을 생성합니다.

사용자 질문 ("삼성전자 2025년 사업보고서 매출액 알려줘")
         │
         ▼
   Claude (LLM) ──도구 호출──▶ MCP 서버 (로컬 프로세스)
                                        │
                           ┌────────────┼───────────────┐
                           ▼            ▼               ▼
                      DART API      KRX API        OpenDART API
                    (전자공시)      (시세·거래량)    (금융감독원)
                           │            │               │
                           └────────────┴───────────────┘
                                        │
                                        ▼
                            Claude가 데이터를 정리해 답변

현재 한국 주식 데이터를 다루는 MCP 서버는 크게 세 종류입니다. 각각의 특징을 먼저 살펴보겠습니다.

세 서버 한눈에 비교

항목	Korea Stock MCP	DART-MCP	Korean DART MCP
저장소	jjlabsio/korea-stock-mcp	2geonhyup/dart-mcp	chrisryugj/korean-dart-mcp
설치 방식	npx	uvx (소스 직접 실행)	npx
연동 API	DART + KRX	DART(전자공시)	OpenDART (83개 → 15개 도구)
API 키 필요	필요 (DART)	필요 (DART)	필요 (OpenDART)
키 발급처	opendart.fss.or.kr	opendart.fss.or.kr	opendart.fss.or.kr
주요 강점	DART+KRX 통합	가벼운 Python 기반	넓은 API 커버리지

세 서버 모두 금융감독원 OpenDART API 키가 필요합니다. 먼저 키부터 발급받겠습니다.

DART API 키 발급 방법

opendart.fss.or.kr에 접속합니다.
우측 상단 회원가입을 클릭해 이메일로 가입합니다.
로그인 후 API 신청 메뉴를 선택합니다.
약관 동의 후 신청 완료하면 즉시 API 키가 발급됩니다 (심사 없음, 무료).
마이페이지 > API 신청 현황에서 발급된 키를 복사해 두세요.

발급된 키는 절대 공개 저장소에 업로드하지 마세요. 설정 파일의 env 블록이나 운영체제 환경 변수로 관리하는 것이 안전합니다.

서버별 상세 설명 및 설치 방법

Korea Stock MCP — DART + KRX 통합 서버

특징: DART 전자공시와 KRX 시세 데이터를 하나의 서버에서 통합 제공합니다. 재무제표 분석과 주가 시세 조회를 동시에 사용하려면 이 서버가 가장 편리합니다.

npx 기반이므로 Node.js가 설치되어 있으면 추가 설치 없이 바로 실행됩니다.

Claude Desktop 설정 파일에 추가할 내용

macOS 기준 설정 파일 위치: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "korea-stock": {
      "command": "npx",
      "args": ["-y", "korea-stock-mcp@latest"],
      "env": {
        "DART_API_KEY": "여기에_발급받은_DART_API_키_입력"
      }
    }
  }
}

활용 예시 프롬프트

“삼성전자 최근 분기 영업이익 추이를 분석해줘”
“코스피 200 편입 종목 중 PBR 1 미만인 종목 리스트”
“카카오뱅크 2024년 사업보고서 요약해줘”

DART-MCP — Python 기반 경량 서버

특징: Python으로 작성된 서버로, uvx를 통해 소스 디렉터리를 직접 실행합니다. 설치 전에 저장소를 직접 클론해야 하는 단계가 있습니다.

# 저장소 클론
git clone https://github.com/2geonhyup/dart-mcp.git ~/Downloads/dart-mcp

# uv가 없다면 먼저 설치
pip install uv

Claude Desktop 설정 파일에 추가할 내용

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

실제 경로는 클론한 위치에 맞게 수정해야 합니다. ~/Downloads/dart-mcp 부분을 실제 디렉터리 경로로 바꿔주세요.

활용 예시 프롬프트

“현대차 최근 3년 재무제표를 표로 정리해줘”
“SK하이닉스 주요 공시 내역 목록 보여줘”

Korean DART MCP — OpenDART 광범위 커버리지

특징: 금융감독원 OpenDART의 83개 API를 정리해 15개 MCP 도구로 압축했습니다. 단일 회사 조회부터 업종별 비교 분석까지 폭넓은 활용이 가능합니다. npx 기반이라 설치가 간단합니다.

Claude Desktop 설정 파일에 추가할 내용

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

활용 예시 프롬프트

“LG에너지솔루션 최대주주 현황 공시 내역 알려줘”
“2024년 4분기 상장폐지 기업 목록 조회해줘”
“삼성바이오로직스 임원 보수 현황 공시 확인해줘”

상황별 권장 선택

어떤 서버를 선택할지 아직 고민된다면 아래 기준을 참고하세요.

상황	권장 서버
주가 시세와 재무제표를 함께 분석하고 싶다	Korea Stock MCP
Python 환경에 익숙하고 가볍게 테스트하고 싶다	DART-MCP
공시 데이터를 최대한 폭넓게 조회하고 싶다	Korean DART MCP
처음 시작해서 가장 빠르게 실행하고 싶다	Korea Stock MCP 또는 Korean DART MCP (npx 한 줄)

npx 기반인 Korea Stock MCP와 Korean DART MCP는 Node.js만 설치되어 있으면 별도 소스 클론 없이 한 줄 명령으로 바로 실행됩니다. 처음이라면 이 두 서버 중 하나부터 시작하는 것을 권장합니다.

Claude Code에서 설정하는 방법

Claude Code를 사용한다면 설정 파일 위치가 다릅니다.

# Claude Code 전역 설정 파일 열기
code ~/.claude/settings.json

형식은 Claude Desktop과 동일하며 mcpServers 블록을 추가하면 됩니다. 설정 저장 후 터미널에서 /mcp 명령을 입력해 서버 연결 상태를 확인하세요. connected 상태가 표시되면 성공입니다.

흔한 오류와 해결

오류 증상	원인	해결 방법
MCP 서버가 disconnected 상태	Node.js 미설치 또는 npx 경로 오류	`node --version`으로 버전 확인, 없으면 nodejs.org에서 설치
API 키 인증 오류 (HTTP 401)	env 블록에 키를 잘못 입력	opendart.fss.or.kr 마이페이지에서 키를 다시 확인 후 붙여넣기
uv 명령을 찾을 수 없음	uv 미설치	`pip install uv` 또는 `pipx install uv`
DART-MCP 실행 시 경로 오류	args의 —directory 경로가 실제 경로와 다름	클론한 디렉터리의 절대 경로를 정확히 입력
서버는 연결됐는데 데이터가 비어 있음	종목 코드 형식 오류	종목 코드는 6자리 숫자 문자열로 입력 (예: 삼성전자는 005930)
KRX 데이터 조회 실패	장 개장 시간 외 시세 조회	KRX 시세는 장 마감 후 확정값 기준, 실시간 틱은 지원 범위 외

자주 묻는 질문

DART API 키는 어디서 발급하나요?

금융감독원 OpenDART 사이트(opendart.fss.or.kr)에 회원가입 후 API 키 신청 메뉴에서 발급받습니다. 심사 없이 즉시 발급되며 무료입니다.

KRX 실시간 주가도 MCP로 조회할 수 있나요?

Korea Stock MCP는 KRX 공식 API를 연동해 상장사 시세·거래량 데이터를 제공합니다. 다만 KRX 데이터는 실시간이 아닌 장 마감 후 기준값이 대부분입니다. 실시간 틱 데이터가 필요하면 별도 증권사 API 연동이 필요합니다.

DART MCP 서버와 Korean DART MCP는 어떻게 다른가요?

DART-MCP(2geonhyup)는 Python 기반으로 uvx로 실행하며, 설치 후 실행 명령에 소스 디렉터리 경로를 지정해야 합니다. Korean DART MCP(chrisryugj)는 npx 기반으로 한 줄 명령으로 바로 실행되며, OpenDART 83개 API를 15개 MCP 도구로 압축해 제공합니다.

Claude Code와 Claude Desktop 중 어디서 쓰는 게 좋나요?

두 클라이언트 모두 MCP 서버를 지원합니다. Claude Code는 터미널 환경에서 /mcp 명령으로 연결 상태를 빠르게 확인할 수 있어 개발자에게 편리합니다. Claude Desktop은 GUI 환경에서 대화형으로 주식 분석을 하려는 투자자에게 적합합니다.

세 서버를 동시에 등록해도 되나요?

네, 가능합니다. 각 서버를 mcpServers 블록에 다른 키 이름으로 등록하면 Claude가 상황에 따라 적절한 도구를 선택해 호출합니다. 단, 유사한 기능의 도구가 중복될 경우 Claude가 혼동할 수 있으므로, 처음에는 가장 필요한 서버 하나부터 시작하는 것을 권장합니다.

API 키를 설정 파일에 직접 넣어도 안전한가요?

설정 파일을 공개 저장소에 올리거나 공유하지 않는다면 실용적인 수준에서 안전합니다. 더 안전하게 관리하려면 운영체제 환경 변수로 키를 설정하고, 설정 파일의 env 블록에서 해당 변수를 참조하는 방식을 사용하세요.

다음 단계

한국 주식 MCP 서버를 연결했다면, Claude에게 “삼성전자 최근 4분기 실적 흐름을 분석해줘”처럼 자연어로 요청해 보세요. 정확한 데이터를 근거로 한 분석이 곧바로 생성됩니다. 아직 MCP모아에 등록되지 않은 금융 MCP 서버가 있다면 /servers 페이지를 통해 확인하거나, /guides에서 다른 MCP 연동 가이드를 찾아보세요.

한국 주식 MCP 서버 비교 — DART·KRX·pykrx 어떤 걸 써야 할까

한국 주식 MCP 서버가 필요한 이유

세 서버 한눈에 비교

DART API 키 발급 방법

서버별 상세 설명 및 설치 방법

Korea Stock MCP — DART + KRX 통합 서버

DART-MCP — Python 기반 경량 서버

Korean DART MCP — OpenDART 광범위 커버리지

상황별 권장 선택

Claude Code에서 설정하는 방법

흔한 오류와 해결

관련 금융 MCP 서버

자주 묻는 질문

DART API 키는 어디서 발급하나요?

KRX 실시간 주가도 MCP로 조회할 수 있나요?

DART MCP 서버와 Korean DART MCP는 어떻게 다른가요?

Claude Code와 Claude Desktop 중 어디서 쓰는 게 좋나요?

세 서버를 동시에 등록해도 되나요?

API 키를 설정 파일에 직접 넣어도 안전한가요?

다음 단계

이 글과 관련된 MCP 서버