Korean Finance MCP Server

Claude Desktop과 연동하는 MCP 서버입니다.
키움증권(주식/채권), KRX(장내채권), 국토부(아파트 실거래가), 한국은행 ECOS(기준금리/환율/물가) 데이터를 제공합니다.

제공 툴 (13개)

키움증권

KRX 장내채권

국토부 실거래가

한국은행 ECOS

API 키 발급

설치

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="국채")