Korean Finance MCP Server
Integrates with Claude Desktop to provide Korean financial data including stock prices, bonds, real estate transactions, and economic indicators from multiple sources.
README
Korean Finance MCP Server
Claude Desktop과 연동하는 MCP 서버입니다.
키움증권(주식/채권), KRX(장내채권), 국토부(아파트 실거래가), 한국은행 ECOS(기준금리/환율/물가) 데이터를 제공합니다.
제공 툴 (13개)
키움증권
| 툴 | 설명 |
|---|---|
get_stock_price |
주식 현재가 조회 |
get_stock_daily_chart |
일봉 차트 (count 지정 가능) |
get_stock_minute_chart |
분봉 차트 (1/3/5/10/15/30/60분) |
get_portfolio |
보유 종목 조회 |
search_otc_bond |
키움 장외채권 상품 검색 |
KRX 장내채권
| 툴 | 설명 |
|---|---|
search_bond |
채권명으로 장내채권 종목 검색 |
get_bond_price |
장내채권 현재 시세 (종가·수익률·전일대비) |
국토부 실거래가
| 툴 | 설명 |
|---|---|
search_region_code |
지역명 → 법정동 코드 검색 |
get_apt_trade |
아파트 매매 실거래가 |
get_apt_rent |
아파트 전월세 실거래가 |
한국은행 ECOS
| 툴 | 설명 |
|---|---|
get_base_rate |
기준금리 추이 |
get_exchange_rate |
환율 (USD/JPY/EUR/CNY) |
get_inflation |
소비자물가지수(CPI) |
API 키 발급
| 서비스 | 발급 링크 | 환경변수 |
|---|---|---|
| 키움증권 Open API | https://apiportal.kiwoom.com | KIWOOM_APP_KEY, KIWOOM_APP_SECRET |
| 공공데이터 포털 | https://www.data.go.kr | DATA_GO_API_KEY |
| 한국은행 ECOS | https://ecos.bok.or.kr/api/#/DevGuide/APIKeyRequest | ECOS_API_KEY |
| KRX 정보데이터시스템 | https://data.krx.co.kr (인증 불필요) | — |
설치
pip install -e .
Claude Desktop 연동
claude_desktop_config.json 파일을 아래와 같이 설정합니다.
파일 위치:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"korean-finance": {
"command": "python",
"args": ["-m", "kiwoom_mcp.server"],
"env": {
"KIWOOM_APP_KEY": "여기에_키움_앱키_입력",
"KIWOOM_APP_SECRET": "여기에_키움_앱시크릿_입력",
"KIWOOM_ACCOUNT_NO": "여기에_계좌번호_입력",
"DATA_GO_API_KEY": "여기에_공공데이터_API키_입력",
"ECOS_API_KEY": "여기에_한국은행_ECOS키_입력",
"KRX_API_KEY": "여기에_KRX_API키_입력"
}
}
}
}
"command"경로는kiwoom-mcp를 설치한 Python 환경의 실행 파일이어야 합니다.
가상환경을 사용하는 경우 절대 경로 사용 권장:
- Windows:
"C:\\Users\\사용자이름\\venv\\Scripts\\python.exe"- macOS/Linux:
"/Users/사용자이름/venv/bin/python"
사용 예시
Claude에게 자연어로 질문하세요:
- "삼성전자 현재 주가 알려줘" →
get_stock_price(stock_code="005930") - "강남구 2025년 3월 아파트 실거래가 보여줘" →
search_region_code→get_apt_trade - "최근 1년 기준금리 추이 보여줘" →
get_base_rate(count=12) - "국고채 3년 현재 시세 알려줘" →
search_bond(bond_name="국고")→get_bond_price - "키움에서 파는 장외채권 알려줘" →
search_otc_bond(bond_type="국채")
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.