한국 주식 MCP 서버 설치·사용법 — DART·KRX 공식 API로 한국 주식 분

Q: Claude Desktop과 Claude Code 중 어디에 설정해야 하나요?

Claude Desktop은 claude_desktop_config.json, Claude Code(CLI)는 ~/.claude/settings.json에 설정합니다. Cursor는 ~/.cursor/mcp.json에 설정합니다. 어느 클라이언트든 설정 형식은 동일합니다.

Q: npx 명령이 실행되지 않을 때 어떻게 하나요?

Node.js 18 이상이 설치되어 있는지 확인하세요. node --version으로 버전을 확인하고, 구버전이면 nodejs.org에서 최신 LTS 버전으로 업데이트합니다. npm cache clean --force 후 재시도도 효과적입니다.

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

설정 파일을 git에 올리지 않도록 주의해야 합니다. .gitignore에 설정 파일을 추가하거나, 운영체제의 환경변수로 따로 관리하는 것이 더 안전합니다. 개인 로컬 환경에서만 사용한다면 직접 입력해도 무방합니다.

DART·KRX 공식 API를 지원하는 한국 주식 MCP 서버를 Claude 또는 Cursor에 연결하면, “삼성전자 3개년 영업이익 보여줘”처럼 자연어 한 문장으로 실제 공시·시세 데이터를 받을 수 있습니다. 이 가이드에서는 API 키 발급부터 설정 파일 작성, 흔한 오류 해결까지 단계별로 설명합니다. 10분이면 설치를 완료할 수 있습니다.

왜 한국 주식 MCP 서버가 필요한가

AI에게 “삼성전자 작년 매출액 알려줘”라고 물으면 대개 학습 데이터 기준의 오래된 수치를 받게 됩니다. MCP(Model Context Protocol) 서버를 연결하면 AI가 실시간으로 외부 API를 호출해 최신 공식 데이터를 가져올 수 있습니다.

한국 주식 분석에 특화된 MCP 서버들은 두 가지 핵심 데이터원을 다룹니다.

데이터원	제공 정보	공식 URL
DART (금융감독원 전자공시)	사업보고서, 재무제표, 주요 공시	opendart.fss.or.kr
KRX (한국거래소)	KOSPI·KOSDAQ 시세, 거래량, 지수	open.krx.co.kr

이 두 데이터를 AI와 연결하면 재무 분석, 공시 모니터링, 종목 비교 등을 프롬프트 한 줄로 처리할 수 있습니다.

서버 선택 — 세 가지 옵션 비교

현재 MCP모아에 등록된 한국 주식 관련 MCP 서버는 다음 세 가지입니다.

서버 이름	지원 API	설치 방식	특징
Korea Stock MCP	DART + KRX	npx	DART와 KRX를 함께 지원
DART MCP 서버	DART	uvx (Python)	로컬 클론 후 실행
Korean DART MCP	OpenDART	npx	83개 API → 15개 도구로 압축

처음 시작이라면 Korea Stock MCP를 권장합니다. npx 한 줄로 설치되고 KRX 시세까지 포함합니다.

데이터 흐름 구조

사용자 자연어 질문
        │
        ▼
AI 클라이언트 (Claude Desktop / Claude Code / Cursor)
        │  MCP 프로토콜
        ▼
한국 주식 MCP 서버 (로컬 프로세스)
        │
        ├──────────────────────────────┐
        ▼                              ▼
DART OpenAPI                     KRX OpenAPI
(opendart.fss.or.kr)         (open.krx.co.kr)
        │                              │
  재무제표 / 공시                 시세 / 거래량
        └──────────────────────────────┘
                        │
                        ▼
          AI가 데이터를 해석·분석 후 응답

1단계 — DART OpenAPI 키 발급

세 서버 모두 DART API 키가 필요합니다. 키 발급은 무료이며 5분이면 완료됩니다.

opendart.fss.or.kr 에 접속합니다.
우측 상단 회원가입을 클릭하고 이메일로 가입합니다.
로그인 후 상단 메뉴 인증키 신청/관리로 이동합니다.
인증키 신청 버튼을 누르고 이용 목적을 입력합니다. 이메일 인증 후 즉시 40자리 키가 발급됩니다.
발급된 키를 복사해 안전한 곳에 보관합니다.

주의: OpenDART API 키는 일일 호출 한도가 있습니다. 한도 초과 시 당일 조회가 제한되므로 대량 분석 시 호출 횟수를 줄여 쿼리하세요.

2단계 — 설치 방법 선택 및 실행

방법 A — Korea Stock MCP (권장, npx)

별도 설치 없이 npx로 즉시 실행됩니다.

npx -y korea-stock-mcp@latest

방법 B — Korean DART MCP (npx)

83개 OpenDART API를 15개 MCP 도구로 통합한 서버입니다.

npx -y korean-dart-mcp

방법 C — DART-MCP (uvx, Python)

Python 기반 서버로, 저장소를 클론한 뒤 실행합니다.

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

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

# 실행
uv --directory ~/Downloads/dart-mcp run dart.py

3단계 — MCP 설정 파일에 서버 등록

AI 클라이언트가 시작할 때 자동으로 MCP 서버를 띄우려면 설정 파일에 서버 블록을 추가해야 합니다.

Claude Desktop 설정 (claude_desktop_config.json)

설정 파일 위치:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Korea Stock MCP 등록 예시:

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

Korean DART MCP 등록 예시:

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

DART-MCP (Python) 등록 예시:

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

Claude Code (CLI) 설정

Claude Code를 사용하는 경우 ~/.claude/settings.json에 동일한 형식으로 추가합니다.

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

Cursor 설정

Cursor는 ~/.cursor/mcp.json에 설정합니다. 형식은 위와 동일합니다.

4단계 — 클라이언트 재시작 및 연결 확인

설정 파일을 저장한 뒤 AI 클라이언트를 완전히 종료하고 다시 시작합니다.

Claude Desktop: 상단 메뉴 → 설정 → MCP에서 서버 상태가 “연결됨”인지 확인합니다.
Claude Code: 터미널에서 /mcp 명령을 실행해 등록한 서버가 connected 상태인지 확인합니다.
Cursor: Settings → MCP 탭에서 등록한 서버 옆에 초록 불이 켜져 있는지 확인합니다.

연결이 성공하면 AI가 한국 주식 관련 도구를 사용할 수 있게 됩니다.

5단계 — 한국 주식 분석 프롬프트 실행

연결이 완료되면 아래 프롬프트를 그대로 입력해 보세요.

재무제표 조회:

“삼성전자의 최근 사업보고서에서 매출액, 영업이익, 당기순이익을 표로 정리해줘”
“현대차와 기아의 작년 부채비율을 비교해줘”
“네이버의 3개년 매출 추이를 분석하고 성장률을 계산해줘”

공시 모니터링:

“SK하이닉스가 최근 한 달간 제출한 공시 목록을 보여줘”
“오늘 유가증권시장에 올라온 주요사항보고서를 요약해줘”

KRX 시세 (Korea Stock MCP 사용 시):

“오늘 KOSPI 상위 5개 종목의 거래량과 등락률을 알려줘”
“삼성전자 최근 한 달 주가 흐름을 분석해줘”

AI는 MCP 서버의 도구를 호출해 기업코드를 조회하고, 해당 보고서나 시세 데이터를 가져와 분석합니다. 사람이 공시 문서나 시세 사이트를 일일이 열어볼 필요가 없습니다.

흔한 오류와 해결법

”Error: command not found: npx”

Node.js가 설치되어 있지 않거나 버전이 낮습니다.

# 버전 확인
node --version

# Node.js 18 미만이면 nodejs.org에서 LTS 버전 다운로드 후 재설치

”DART API 키가 유효하지 않습니다” 또는 인증 오류

설정 파일에 입력한 키 값을 다시 확인합니다. 복사 시 앞뒤 공백이 포함됐는지, 따옴표가 제대로 닫혔는지 점검합니다.

"DART_API_KEY": "abc123...xyz"

키 값에 특수문자가 없어야 합니다. opendart.fss.or.kr에 로그인해 키가 정상 상태인지 재확인하세요.

”MCP server not connected” 오류

설정 파일의 JSON 문법 오류가 가장 흔한 원인입니다. 쉼표 누락이나 괄호 불일치를 확인합니다. JSON 검증 도구(예: jsonlint.com)에 붙여넣어 구문 오류를 먼저 제거하세요.

npx 실행 속도가 느림

첫 실행 시 패키지를 다운로드하므로 느릴 수 있습니다. 이후에는 캐시에서 빠르게 로드됩니다. 네트워크 환경이 느리다면 npm install -g korea-stock-mcp로 전역 설치 후 command를 korea-stock-mcp로 변경할 수도 있습니다.

uv 명령어를 찾을 수 없음 (DART-MCP 사용 시)

Python의 uv 패키지 관리자가 설치되어 있지 않습니다.

pip install uv
# 또는
curl -LsSf https://astral.sh/uv/install.sh | sh

여러 서버를 동시에 등록하기

목적에 따라 여러 서버를 함께 등록할 수 있습니다. mcpServers 객체에 키만 다르게 추가하면 됩니다.

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

다만 동일 API를 두 서버가 중복 호출하면 일일 한도가 빠르게 소진될 수 있으니, 주된 용도에 맞는 서버 하나만 먼저 사용해 보기를 권장합니다.

자주 묻는 질문

Q. DART API 키는 유료인가요?

아니요, OpenDART API 키는 무료입니다. opendart.fss.or.kr에서 회원가입 후 무료로 발급받을 수 있으며, 일일 호출 한도 내에서 자유롭게 사용할 수 있습니다.

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

Korea Stock MCP는 DART와 KRX 두 가지 공식 API를 모두 지원해 재무제표와 실시간 시세 데이터를 함께 다룰 수 있습니다. Korean DART MCP는 OpenDART의 83개 API를 15개 MCP 도구로 압축해 공시·재무 분석에 특화되어 있습니다. 시세 데이터가 필요하면 Korea Stock MCP, 공시 분석에 집중한다면 Korean DART MCP가 적합합니다.

Q. Claude Desktop과 Claude Code 중 어디에 설정해야 하나요?

Claude Desktop은 ~/Library/Application Support/Claude/claude_desktop_config.json, Claude Code(CLI)는 ~/.claude/settings.json에 설정합니다. Cursor는 ~/.cursor/mcp.json에 설정합니다. 어느 클라이언트든 설정 형식은 동일합니다.

Q. npx 명령이 실행되지 않을 때 어떻게 하나요?

Node.js 18 이상이 설치되어 있는지 확인하세요. node --version으로 버전을 확인하고, 구버전이면 nodejs.org에서 최신 LTS 버전으로 업데이트합니다. npm cache clean --force 후 재시도도 효과적입니다.

Q. DART-MCP 서버는 왜 uvx 방식을 사용하나요?

DART-MCP는 Python 기반으로 작성된 서버입니다. uvx는 Python 패키지 실행 도구로, Node.js의 npx와 같은 역할을 합니다. uv 패키지 관리자가 설치되어 있어야 하며, pip install uv로 설치할 수 있습니다.

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

설정 파일을 git에 올리지 않도록 주의해야 합니다. .gitignore에 설정 파일을 추가하거나, 운영체제의 환경변수로 따로 관리하는 것이 더 안전합니다. 개인 로컬 환경에서만 사용한다면 직접 입력해도 무방합니다.

다음 단계

한국 주식 MCP 서버를 설치했다면, 아래 서버들도 함께 활용해 보세요.

Korea Stock MCP 서버 상세 페이지 — GitHub 저장소 및 지원 도구 목록 확인
DART MCP 서버 — Python 기반 DART 전용 서버
Korean DART MCP — 83개 공시 API를 15개 도구로 압축한 서버
금융 카테고리 전체 서버 보기 — ECOS, KIS 등 다른 금융 MCP 서버 탐색
MCP 서버 전체 목록 — 한국 MCP 서버 디렉토리 전체 검색
가이드 목록 보기 — Claude Desktop, Cursor 설정 등 다른 설치 가이드