Korea Stock Analyzer MCP는 API 키가 필요한가요?

아니요. pykrx와 KRX 공개 데이터를 사용하므로 별도 API 키 등록 없이 바로 사용할 수 있습니다.

한국 주식 분석기 MCP 설치·사용법 — 6대 투자 대가 전략으로 한국 주식(KOSP

Q: Claude Desktop 말고 Cursor에서도 쓸 수 있나요?

네. Cursor의 MCP 설정 파일(mcp.json)에 동일한 방식으로 korea-stock-analyzer 항목을 추가하면 Cursor AI에서도 동일하게 동작합니다.

Q: 6대 투자 대가 전략이란 구체적으로 어떤 전략인가요?

서버가 구현한 전략은 공식 GitHub 저장소(https://github.com/Mrbaeksang/korea-stock-analyzer-mcp)에서 확인할 수 있습니다. 일반적으로 가치투자·모멘텀·배당 등 주요 퀀트 기법을 포함합니다.

Q: Windows에서도 설치할 수 있나요?

네. Node.js가 설치된 Windows 환경에서 동일한 npx 명령으로 실행됩니다. 단, 내부적으로 Python 환경이 필요한 경우 Python도 설치되어 있어야 합니다.

API 키 없이 Claude·Cursor에서 한국 주식을 바로 분석할 수 있습니다. Korea Stock Analyzer MCP는 pykrx와 KRX 공개 데이터를 기반으로 KOSPI·KOSDAQ 종목을 6대 투자 대가 전략으로 평가해 주는 MCP 서버입니다. npx 한 줄로 설치가 끝나고, Claude 대화창에서 자연어로 종목 분석을 요청하면 됩니다. 이 가이드에서는 설치부터 실전 분석 쿼리, 오류 해결까지 단계별로 안내합니다.

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

일반적인 AI 채팅은 실시간 주가나 재무 데이터에 접근하지 못합니다. Model Context Protocol(MCP)은 AI가 외부 도구·데이터 소스를 직접 호출할 수 있게 해주는 표준 규약입니다. Korea Stock Analyzer MCP를 연결하면 Claude가 KRX 데이터를 직접 조회하고, 종목별 투자 지표를 계산해 즉각 분석 결과를 내놓습니다.

사용자 (자연어 질문)
      │
      ▼
Claude Desktop / Cursor
      │  MCP 프로토콜
      ▼
Korea Stock Analyzer MCP 서버
      │  pykrx 라이브러리
      ▼
KRX(KOSPI/KOSDAQ) 공개 데이터
      │
      ▼
분석 결과 → Claude 답변

추가로 DART 전자공시 데이터가 필요하면 DART MCP 서버를, KRX·DART를 함께 쓰고 싶으면 Korea Stock MCP를 병행 설치할 수 있습니다.

Korea Stock Analyzer MCP란?

항목	내용
서버 이름	Korea Stock Analyzer MCP
분석 대상	KOSPI·KOSDAQ 전 종목
데이터 소스	pykrx (KRX 공식 데이터)
API 키 필요	없음
설치 방식	npx
GitHub	Mrbaeksang/korea-stock-analyzer-mcp

이 서버의 핵심 특징은 6대 투자 대가 전략을 내장하고 있다는 점입니다. 자연어로 “워런 버핏 전략으로 삼성전자 분석해줘”라고 요청하면 해당 전략에 맞는 지표를 계산해 종합 의견을 제시합니다. 별도의 코딩이나 데이터 수집 없이 전략적 분석이 가능합니다.

준비물

Node.js 18 이상 — node --version으로 확인
Claude Desktop (또는 MCP를 지원하는 Cursor 최신 버전)
인터넷 연결 (KRX 데이터 조회용)
API 키: 필요 없음

단계별 설치 방법

1단계: Node.js 설치 확인

터미널을 열고 아래 명령을 실행합니다.

node --version

v18.x.x 이상이 출력되면 준비가 된 것입니다. Node.js가 없다면 nodejs.org에서 LTS 버전을 내려받아 설치하세요.

2단계: Claude Desktop 설정 파일 열기

Claude Desktop의 MCP 설정 파일 위치는 운영체제마다 다릅니다.

운영체제	설정 파일 경로
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

파일이 없다면 새로 만들면 됩니다.

3단계: Korea Stock Analyzer MCP 설정 추가

설정 파일을 열고 아래 내용을 추가합니다. 기존에 다른 MCP 서버가 있다면 mcpServers 객체 안에 항목을 추가하면 됩니다.

{
  "mcpServers": {
    "korea-stock-analyzer": {
      "command": "npx",
      "args": ["@mrbaeksang/korea-stock-analyzer-mcp"]
    }
  }
}

설정 파일을 저장합니다.

4단계: Claude Desktop 재시작

설정 반영을 위해 Claude Desktop을 완전히 종료한 뒤 다시 실행합니다. macOS라면 메뉴바에서 “Quit Claude”를 선택해야 합니다. 단순히 창을 닫는 것으로는 완전히 종료되지 않을 수 있습니다.

재시작 후 Claude 대화창에서 망치 아이콘(도구 목록)을 클릭해 korea-stock-analyzer 관련 도구가 표시되면 연결 성공입니다.

5단계: Cursor에 설치하는 경우

Cursor를 사용한다면 프로젝트 루트 또는 홈 디렉터리의 .cursor/mcp.json을 편집합니다.

{
  "mcpServers": {
    "korea-stock-analyzer": {
      "command": "npx",
      "args": ["@mrbaeksang/korea-stock-analyzer-mcp"]
    }
  }
}

Cursor를 재시작하면 AI 채팅 패널에서 동일하게 사용할 수 있습니다.

실전 사용 예시

설치 후 Claude 대화창에서 자연어로 다음과 같이 요청해 보세요.

종목 기본 분석

“삼성전자 최근 주가 흐름과 재무 지표를 요약해줘.”

투자 대가 전략 적용

“카카오를 성장주 투자 전략 관점에서 분석해줘.”

섹터 비교

“반도체 섹터 KOSPI 종목들 중 PER이 낮은 상위 5개를 알려줘.”

Claude는 KRX 공개 데이터를 실시간으로 조회해 분석 결과를 텍스트로 정리해 줍니다.

흔한 오류와 해결 방법

”MCP server not connected” 오류

Claude Desktop을 완전히 종료한 뒤 다시 실행하세요. 설정 파일의 JSON 문법이 올바른지도 확인합니다. 쉼표 누락이나 따옴표 오류가 가장 흔한 원인입니다.

JSON 유효성은 온라인 JSON 검증기(예: jsonlint.com)를 활용하거나 터미널에서 확인할 수 있습니다.

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python3 -m json.tool

오류 없이 JSON이 출력되면 문법은 정상입니다.

”npx: command not found” 오류

Node.js가 설치되지 않았거나 PATH에 등록되지 않은 경우입니다. Node.js를 설치한 뒤 터미널을 새로 열고 node --version으로 확인하세요.

데이터가 업데이트되지 않는 경우

pykrx는 KRX 거래일 마감 후 데이터를 제공합니다. 주말이나 공휴일에는 최근 거래일 기준 데이터가 반환됩니다. 이는 서버 특성상 정상 동작입니다.

서버	API 키	주요 데이터	특징
한국 주식 분석기 MCP	불필요	KRX 주가·지표	투자 대가 전략 내장
Korea Stock MCP	DART 키 필요	DART·KRX	공시 + 주가 통합
DART MCP	DART 키 필요	전자공시·재무제표	상세 재무 분석

자주 묻는 질문

API 키가 필요한가요?

아니요. Korea Stock Analyzer MCP는 pykrx와 KRX 공개 데이터를 사용하므로 별도 API 키 등록 없이 바로 사용할 수 있습니다.

Claude Desktop 말고 Cursor에서도 쓸 수 있나요?

네. Cursor의 MCP 설정 파일(.cursor/mcp.json)에 동일한 방식으로 korea-stock-analyzer 항목을 추가하면 Cursor AI에서도 동일하게 동작합니다.

6대 투자 대가 전략이란 구체적으로 어떤 전략인가요?

서버가 구현한 전략의 상세 목록은 공식 GitHub 저장소(github.com/Mrbaeksang/korea-stock-analyzer-mcp)에서 확인할 수 있습니다. 일반적으로 가치투자·모멘텀·배당 등 주요 퀀트 기법을 포함합니다.

실시간 주가 데이터인가요?

pykrx는 KRX에서 제공하는 공식 데이터를 조회합니다. 장 마감 후 데이터가 업데이트되므로 실시간이 아닌 일별 종가 기준으로 동작합니다.

Windows에서도 설치할 수 있나요?

네. Node.js가 설치된 Windows 환경에서 동일한 npx 명령으로 실행됩니다. 내부적으로 Python 환경이 필요한 경우 Python도 함께 설치되어 있어야 합니다.

다른 한국 주식 MCP 서버와 차이점은 무엇인가요?

Korea Stock Analyzer MCP는 API 키 없이 즉시 사용 가능하며 투자 대가 전략 분석에 특화되어 있습니다. DART 공시 데이터가 필요하면 Korea Stock MCP나 DART MCP를 함께 활용하세요.

다음 단계

Korea Stock Analyzer MCP를 설치했다면, 더 풍부한 분석을 위해 아래 서버들도 살펴보세요.

한국 주식 분석기 MCP 서버 페이지 — 상세 스펙과 커뮤니티 리뷰 확인
Korea Stock MCP — DART 공시 데이터와 KRX 주가를 함께 조회
DART MCP — 전자공시 재무제표 심층 분석
finance 카테고리 전체 보기 — 한국 금융 관련 MCP 서버 목록
MCP 서버 전체 목록 — 분야별 다양한 한국 MCP 서버 탐색