{
  "markdown": "# pykrx-mcp\n\n[![PyPI version](https://badge.fury.io/py/pykrx-mcp.svg)](https://badge.fury.io/py/pykrx-mcp)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![Open in Dev Containers](https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/sharebook-kr/pykrx-mcp)\n\n한국 주식 시장 데이터를 AI 에이전트에게 제공하는 MCP (Model Context Protocol) 서버입니다.\n\n[pykrx](https://github.com/sharebook-kr/pykrx) 라이브러리를 기반으로 KOSPI, KOSDAQ, KONEX 시장의 주가, 재무제표, 투자자별 수급, 공매도 등 다양한 데이터를 ChatGPT와 Claude에서 자연어로 조회할 수 있습니다.\n\n---\n\n## ☕ 후원하기\n\n프로젝트가 도움이 되었다면 개발자를 응원해주세요!\n\n[![Sponsor](https://img.shields.io/badge/Sponsor-GitHub-pink?style=for-the-badge&logo=github)](https://github.com/sponsors/sharebook-kr)\n\n---\n\n## 1. 시작하기\n\n### 1.1 Claude Desktop에서 사용하기\n\n#### 자동 설치 (권장)\n\nMCP Registry를 통한 원클릭 설치:\n\n```bash\nnpx @modelcontextprotocol/inspector install pykrx-mcp\n```\n\n#### 수동 설치\n\nClaude Desktop 설정 파일을 직접 수정:\n\n**macOS/Linux**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"pykrx\": {\n      \"command\": \"uvx\",\n      \"args\": [\"pykrx-mcp\"]\n    }\n  }\n}\n```\n\n설정 후 Claude Desktop을 재시작하면 바로 사용할 수 있습니다.\n\n---\n\n## 2. 지원하는 데이터 및 API\n\n> 모든 API는 [pykrx 라이브러리](https://github.com/sharebook-kr/pykrx)를 기반으로 구현되었습니다.\n\n### 2.1 주식 데이터 (Stock Data)\n\n#### 2.1.1 종목 정보\n- `get_market_ticker_list`: 시장별 종목 코드 조회\n- `get_market_ticker_name`: 종목 코드로 종목명 조회\n\n#### 2.1.2 가격 데이터\n- `get_stock_ohlcv`: 개별 종목 OHLCV (시가/고가/저가/종가/거래량)\n- `get_market_ohlcv_by_date`: 특정 일자 전종목 시세\n- `get_market_price_change`: 기간별 전종목 가격 변동\n\n#### 2.1.3 시가총액\n- `get_market_cap_by_date`: 개별 종목 시가총액 조회\n\n#### 2.1.4 재무 지표\n- `get_market_fundamental_by_date`: PER, PBR, EPS, DIV, BPS, DPS\n\n#### 2.1.5 투자자별 거래\n- `get_market_trading_value_by_date`: 종목별 투자자 수급 (거래대금)\n- `get_market_trading_volume_by_investor`: 투자자별 거래량\n- `get_market_trading_value_by_investor`: 투자자별 거래대금\n- `get_market_net_purchases_of_equities`: 투자자별 순매수 상위 종목\n\n### 2.2 지수 데이터 (Index Data)\n\n#### 2.2.1 지수 정보\n- `get_index_ticker_list`: 지수 티커 목록\n- `get_index_ticker_name`: 지수 이름 조회\n- `get_index_portfolio_deposit_file`: 지수 구성 종목\n\n#### 2.2.2 지수 가격\n- `get_index_ohlcv`: 지수 OHLCV 데이터\n\n#### 2.2.3 지수 지표\n- `get_index_fundamental`: 지수 PER/PBR/배당수익률\n\n### 2.3 공매도 데이터 (Short Selling)\n\n- `get_shorting_status_by_date`: 종목별 공매도 현황\n- `get_shorting_volume_by_ticker`: 전종목 공매도 거래량\n- `get_shorting_balance_top50`: 공매도 잔고 상위 50\n- `get_shorting_volume_top50`: 공매도 거래 비중 상위 50\n\n### 2.4 외국인 투자 (Foreign Investment)\n\n- `get_exhaustion_rates_of_foreign_investment`: 외국인 보유량 및 한도소진률\n\n### 2.5 ETF 데이터\n\n- `get_etf_ticker_list`: ETF 종목 리스트\n- `get_etf_ohlcv_by_date`: ETF OHLCV 데이터\n\n**총 23개의 데이터 조회 도구 지원**\n\n---\n\n## 3. 사용 예시\n\n### 3.1 주가 조회\n\n**개별 종목 주가**\n```\n\"삼성전자 최근 한달 주가 보여줘\"\n\"SK하이닉스 2024년 1월 OHLCV 데이터\"\n\"카카오 지난주 주가 움직임 분석해줘\"\n```\n\n**시장 전체 시세**\n```\n\"코스피 전종목 오늘 시세 보여줘\"\n\"코스닥 상위 10개 종목 가격 변동률\"\n```\n\n### 3.2 시가총액 & 거래량\n\n```\n\"삼성전자 시가총액이 얼마야?\"\n\"삼성전자 최근 한달 거래량 추이\"\n\"네이버 거래대금 분석해줘\"\n```\n\n### 3.3 재무 지표\n\n```\n\"삼성전자 PER, PBR 알려줘\"\n\"삼성전자 배당수익률 얼마야?\"\n\"네이버 최근 EPS는?\"\n```\n\n### 3.4 투자자별 수급 분석\n\n```\n\"삼성전자 외국인 매수세 어때?\"\n\"카카오 최근 기관 수급 분석\"\n\"코스피 개인 투자자가 많이 산 종목\"\n\"외국인이 순매수한 상위 10개 종목\"\n```\n\n### 3.5 공매도 분석\n\n```\n\"삼성전자 공매도 비중 얼마야?\"\n\"코스피 공매도 상위 종목 알려줘\"\n\"공매도 잔고가 가장 높은 종목은?\"\n```\n\n### 3.6 지수 조회\n\n```\n\"코스피 지수 최근 한달 추이\"\n\"코스닥 150 지수 PER은?\"\n\"반도체 섹터 지수 구성 종목 알려줘\"\n```\n\n### 3.7 외국인 투자\n\n```\n\"삼성전자 외국인 보유 비중은?\"\n\"외국인 한도소진률 높은 종목\"\n```\n\n### 3.8 종목 검색\n\n```\n\"코스피 종목 리스트\"\n\"005930 종목명이 뭐야?\"\n\"오늘 거래된 ETF 리스트\"\n```\n\n---\n\n## 4. 주요 특징\n\n### 4.1 자연어 대화형 인터페이스\n복잡한 API 문법 없이 일상 언어로 데이터를 조회할 수 있습니다.\n\n### 4.2 실시간 한국 주식 시장 데이터\nKRX(한국거래소)의 최신 데이터를 제공합니다.\n\n### 4.3 다양한 분석 기능\n- 가격 추이 분석\n- 투자자별 수급 분석\n- 재무 지표 비교\n- 공매도 현황 분석\n\n### 4.4 AI 에이전트 최적화\nChatGPT와 Claude에서 바로 사용할 수 있도록 MCP 프로토콜을 지원합니다.\n\n---\n\n## 5. 기술 스택\n\n- **Python 3.10+**\n- **[pykrx](https://github.com/sharebook-kr/pykrx)**: 한국 주식 시장 데이터 수집\n- **[FastMCP](https://github.com/jlowin/fastmcp)**: MCP 서버 프레임워크\n- **MCP (Model Context Protocol)**: AI 에이전트와의 통신 프로토콜\n\n---\n\n## 6. 개발자 정보\n\n### 6.1 로컬 개발 환경 설정\n\n자세한 내용은 [DEVELOPMENT.md](DEVELOPMENT.md)를 참고하세요.\n\n```bash\n# 저장소 클론\ngit clone https://github.com/sharebook-kr/pykrx-mcp.git\ncd pykrx-mcp\n\n# 의존성 설치\nuv pip install -e \".[dev]\"\n\n# 테스트 실행\nuv run pytest\n\n# 서버 실행\nuv run pykrx-mcp\n```\n\n### 6.2 기여하기\n\n이슈 및 풀 리퀘스트를 환영합니다!\n\n---\n\n## 7. 라이선스\n\nMIT License - 자유롭게 사용하세요!\n\n---\n\n## 8. 관련 프로젝트\n\n- **[pykrx](https://github.com/sharebook-kr/pykrx)**: 한국 주식 시장 데이터 수집 라이브러리 (본 프로젝트의 기반)\n- **[MCP](https://modelcontextprotocol.io/)**: Model Context Protocol 공식 문서\n",
  "bytes": 4660,
  "sha": "66c94755558c70fe9157e1569263ecfbd9c272de91c856b06cfcbc808c898987",
  "repo_slug": "sharebook-kr/pykrx-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sharebook_kr_pykrx_mcp_970df302/readme"
}