한국 금융 MCP 설치·사용법 — 한국은행 ECOS·DART·KRX·국토부 실거래가를 AI로

Q: DART MCP 서버만 단독으로 쓰고 싶다면 어떻게 하나요?

github.com/2geonhyup/dart-mcp 를 클론한 뒤 uvx(uv 런타임)로 실행하면 됩니다. opendart.fss.or.kr 에서 발급한 API 키 하나로 전자공시 전체를 조회할 수 있습니다.

한국 금융 MCP 서버를 Claude Desktop이나 Cursor에 연결하면, DART 전자공시 재무제표·한국은행 ECOS 거시지표·KRX 시세·국토부 실거래가를 자연어로 한 번에 물어볼 수 있습니다. 이 가이드는 Korea Finance MCP, Korea Stock MCP, DART MCP 세 가지 서버의 설치 방법과 실전 활용 사례를 단계별로 설명합니다. API 키 발급부터 Claude 연동 확인까지 30분 이내에 완료할 수 있습니다.

왜 한국 금융 MCP가 필요한가

국내 금융 분석을 할 때 가장 불편한 점은 데이터 소스가 분산되어 있다는 것입니다. 한국은행 ECOS에서 기준금리를 확인하고, DART에서 사업보고서를 내려받고, KRX에서 시세를 따로 조회해야 합니다. 부동산 가격은 또 국토부 RTMS와 한국부동산원 R-ONE이 나뉘어 있습니다.

MCP(Model Context Protocol) 서버를 사용하면 이 과정이 바뀝니다. Claude나 Cursor에게 “삼성전자 최근 4개 분기 영업이익 추이를 DART로 뽑아줘”라고 말하면, AI가 직접 공공 API를 호출해 결과를 정리해 돌려줍니다. 데이터를 수집하는 시간을 줄이고 분석과 의사결정에 집중할 수 있습니다.

한국 금융 MCP 서버 3종 비교

아래 표를 보고 본인의 필요에 맞는 서버를 선택하세요.

서버	연동 API	설치 방식	API 키 필요
Korea Finance MCP	ECOS, DART, KRX, 국토부 RTMS, R-ONE, data.go.kr	HTTP-SSE (직접 실행)	여러 개
Korea Stock MCP	DART, KRX	npx	DART 키 1개
DART MCP	DART(전자공시시스템)	uvx	DART 키 1개

DART 재무 분석만 필요하다면 DART MCP가 가장 간단합니다. 주식 분석까지 원한다면 Korea Stock MCP를 추천합니다. 부동산·거시경제 지표까지 모두 아우르는 종합 금융 데이터가 필요하다면 Korea Finance MCP를 선택하세요.

데이터 흐름 구조

Claude Desktop / Cursor
        |
        | MCP 프로토콜 (JSON-RPC over HTTP-SSE 또는 stdio)
        v
  Korea Finance MCP 서버  (로컬 실행)
        |
        +---> 한국은행 ECOS API    (기준금리, GDP, CPI 등)
        +---> DART OpenDART API   (사업보고서, 재무제표)
        +---> KRX API             (주식·ETF 시세)
        +---> 국토부 RTMS API     (아파트·상업용 실거래가)
        +---> 한국부동산원 R-ONE  (부동산 통계)
        +---> data.go.kr          (공공 금융 데이터)

준비물

설치를 시작하기 전에 아래 항목을 미리 준비하세요.

Node.js 18 이상 — Korea Stock MCP(npx) 실행에 필요
Python 3.11 이상 + uv — DART MCP(uvx) 실행에 필요
Git — 저장소 클론에 필요
API 키 (사용할 서버에 따라 선택):
- 한국은행 ECOS: ecos.bok.or.kr 회원가입 후 API 서비스 신청
- DART: opendart.fss.or.kr 회원가입 후 API 인증키 발급
- data.go.kr: data.go.kr 회원가입 후 국토부 실거래가 API 활용 신청
Claude Desktop 또는 MCP를 지원하는 AI 클라이언트

Korea Finance MCP 설치 방법 (HTTP-SSE)

Korea Finance MCP는 HTTP-SSE 방식으로 동작합니다. npx나 uvx처럼 단일 명령으로 실행되는 구조가 아니므로, 저장소를 직접 클론해 서버를 기동해야 합니다.

1단계 — API 키 발급

각 기관 사이트에서 API 키를 발급받습니다. DART 키는 신청 후 영업일 1~2일 이내에 이메일로 발송됩니다.

2단계 — 저장소 클론 및 의존성 설치

git clone https://github.com/emceeKim/korea-finance-mcp.git
cd korea-finance-mcp
npm install

3단계 — 환경 변수 설정

저장소 루트에 .env 파일을 생성하고 발급받은 API 키를 입력합니다. (키 이름은 저장소의 README나 .env.example을 참고하세요.)

# .env 파일 예시 — 실제 키 이름은 저장소 README를 반드시 확인
ECOS_API_KEY=발급받은_ECOS_키
DART_API_KEY=발급받은_DART_키
DATA_GO_KR_API_KEY=발급받은_data.go.kr_키
PORT=3000

4단계 — 서버 실행

npm start
# 또는 저장소에서 제공하는 실행 스크립트 확인

서버가 정상적으로 기동되면 http://localhost:3000 에서 SSE 엔드포인트가 열립니다.

5단계 — Claude Desktop 설정 등록

Claude Desktop 설정 파일을 엽니다.

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

아래 내용을 mcpServers 객체에 추가하세요.

{
  "mcpServers": {
    "korea-finance-mcp": {
      "url": "http://localhost:3000/sse"
    }
  }
}

설정 저장 후 Claude Desktop을 완전히 종료했다가 다시 실행하세요.

6단계 — 동작 확인

Claude Desktop에서 다음과 같이 질문해 보세요.

“한국은행 ECOS에서 최근 기준금리 변동 이력을 조회해줘.”

ECOS API 응답이 텍스트로 정리되어 나오면 설치가 완료된 것입니다.

Korea Stock MCP 설치 방법 (npx)

주식·공시 분석에 집중하고 싶다면 Korea Stock MCP를 사용하세요. npx로 바로 실행할 수 있어 설치가 간편합니다.

Claude Desktop 설정

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

DART API 키는 opendart.fss.or.kr에서 발급받으세요. 설정 저장 후 Claude Desktop을 재시작하면 바로 사용할 수 있습니다.

DART MCP 설치 방법 (uvx)

전자공시 재무 분석에 특화된 DART MCP는 Python uv 런타임으로 실행합니다.

저장소 클론

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

Claude Desktop 설정

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

경로는 본인이 클론한 디렉터리로 맞춰 수정하세요.

흔한 오류와 해결 방법

”MCP 서버에 연결할 수 없습니다”

Korea Finance MCP(HTTP-SSE) 사용 시 서버 프로세스가 실행 중인지 먼저 확인하세요. npm start를 실행한 터미널을 닫으면 서버도 종료됩니다. 터미널을 닫아도 계속 실행하려면 pm2 또는 nohup을 사용하세요.

# pm2로 백그라운드 실행 예시
npm install -g pm2
pm2 start npm --name "korea-finance-mcp" -- start
pm2 save

”API 키가 유효하지 않습니다” 오류

DART API 키는 발급 후 최대 2영업일이 걸립니다. 이메일로 수신 확인 후 사용하세요.
ECOS API 키는 발급 즉시 사용 가능하지만, API 서비스 신청 시 이용 목적을 정확히 기재해야 합니다.
.env 파일에 따옴표나 공백이 포함되지 않았는지 확인하세요.

npx 실행 시 버전 오류

# 캐시 초기화 후 재실행
npx clear-npx-cache
npx -y korea-stock-mcp@latest

uvx 경로 오류

uv 명령이 없다면 먼저 uv를 설치하세요.

curl -LsSf https://astral.sh/uv/install.sh | sh

실전 활용 예시

아래는 각 서버를 통해 Claude에 요청할 수 있는 실제 질문 예시입니다.

목적	질문 예시	사용 서버
거시경제 분석	”한국 소비자물가 상승률 최근 12개월 추이를 ECOS로 보여줘”	Korea Finance MCP
기업 재무 분석	”카카오 2024년 사업보고서에서 영업이익과 부채비율을 뽑아줘”	DART MCP / Korea Stock MCP
부동산 시세	”강남구 아파트 최근 3개월 평균 실거래가를 국토부 데이터로 조회해줘”	Korea Finance MCP
주식 분석	”코스피 200 구성종목 중 PER 10 미만인 종목을 KRX 데이터로 찾아줘”	Korea Stock MCP

자주 묻는 질문

한국 금융 MCP를 사용하려면 유료 API가 필요한가요?

Korea Finance MCP가 연동하는 한국은행 ECOS, DART(금융감독원), data.go.kr, KRX 데이터는 모두 무료 공공 API입니다. 다만 각 기관에서 개별 API 키를 발급받아야 하며, 일부 API는 일일 호출 한도가 있습니다.

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

네. MCP 프로토콜을 지원하는 모든 클라이언트(Cursor, VS Code Copilot 등)에서 동일한 설정 구조로 연결할 수 있습니다. 클라이언트별 설정 파일 경로와 JSON 키 이름이 다를 수 있으니 각 클라이언트 공식 문서를 확인하세요.

국토부 실거래가 데이터는 어떤 API를 통해 제공되나요?

국토교통부 실거래가 공개시스템(RTMS)과 한국부동산원 R-ONE API를 통해 아파트·연립·상업용 부동산 실거래가를 조회합니다. 두 API 모두 data.go.kr 공공데이터포털에서 키를 발급받을 수 있습니다.

Korea Stock MCP와 Korea Finance MCP의 차이점은 무엇인가요?

Korea Finance MCP는 한국은행 ECOS(거시경제 지표), DART, KRX, 국토부 실거래가, 한국부동산원 R-ONE 등 다양한 금융·부동산 데이터를 HTTP-SSE 방식으로 통합 제공합니다. Korea Stock MCP는 DART·KRX 중심의 주식 분석에 특화되어 있으며 npx로 간편하게 실행할 수 있습니다.

API 키를 여러 개 관리하기 어렵습니다. 꼭 다 받아야 하나요?

필요한 데이터 소스만 선택해 해당 API 키만 설정해도 됩니다. 예를 들어 DART 재무 분석만 필요하다면 DART 키만 입력하면 됩니다. 나머지 엔드포인트는 키가 없으면 자동으로 비활성화될 수 있으니 저장소 README를 확인하세요.

DART MCP 서버만 단독으로 쓰고 싶다면 어떻게 하나요?

github.com/2geonhyup/dart-mcp를 클론한 뒤 uvx(uv 런타임)로 실행하면 됩니다. opendart.fss.or.kr에서 발급한 API 키 하나로 전자공시 전체를 조회할 수 있습니다.

다음 단계

한국 금융 MCP를 설치했다면 아래 방향으로 활용 범위를 넓혀보세요.

금융 카테고리 전체 서버 목록 보기 — 국내 금융 관련 MCP 서버를 한눈에 확인
Korea Finance MCP 서버 상세 — 지원 도구 목록, 업데이트 이력 확인
MCP 서버 전체 목록 — 다른 분야(법률, 공공데이터, 지도 등)의 한국 MCP 서버 탐색
MCP모아에 서버 등록하기 — 직접 만든 한국 금융 MCP 서버가 있다면 등록해 공유하세요

한국 공공 금융 API는 지속적으로 개선되고 있습니다. 각 서버의 GitHub 저장소를 즐겨찾기해 두고, 업데이트가 있을 때 최신 버전을 유지하는 것이 좋습니다.

왜 한국 금융 MCP가 필요한가

한국 금융 MCP 서버 3종 비교

데이터 흐름 구조

준비물

Korea Finance MCP 설치 방법 (HTTP-SSE)

1단계 — API 키 발급

2단계 — 저장소 클론 및 의존성 설치

3단계 — 환경 변수 설정

4단계 — 서버 실행

5단계 — Claude Desktop 설정 등록

6단계 — 동작 확인

Korea Stock MCP 설치 방법 (npx)

Claude Desktop 설정

DART MCP 설치 방법 (uvx)

저장소 클론

Claude Desktop 설정

흔한 오류와 해결 방법

”MCP 서버에 연결할 수 없습니다”

”API 키가 유효하지 않습니다” 오류

npx 실행 시 버전 오류

uvx 경로 오류

실전 활용 예시

자주 묻는 질문

한국 금융 MCP를 사용하려면 유료 API가 필요한가요?

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

국토부 실거래가 데이터는 어떤 API를 통해 제공되나요?

Korea Stock MCP와 Korea Finance MCP의 차이점은 무엇인가요?

API 키를 여러 개 관리하기 어렵습니다. 꼭 다 받아야 하나요?

DART MCP 서버만 단독으로 쓰고 싶다면 어떻게 하나요?

다음 단계

이 글과 관련된 MCP 서버