initial commit

한국투자증권(API)/MCP/README.MD

@@ -0,0 +1,78 @@
+# 한국투자증권 MCP: 투자 코딩이 쉬워지는 순간
+
+## 🚀 소개
+
+한국투자증권에서 개발자들을 위한 혁신적인 도구를 공개합니다. **MCP(Model Context Protocol)**를 활용해 AI 모델이 증권 데이터에 직접 접근할 수 있는 두 가지 도구를 제공합니다:
+
+1. **KIS Code Assistant MCP**: 한국투자증권 OpenAPI 사용법과 샘플코드를 AI 도구가 검색/제공
+2. **KIS Trading MCP** : 한국투자증권 OpenAPI를 AI 도구에서 직접 호출
+
+## 🔧 지원 기능
+
+### KIS Code Assistant MCP
+  https://smithery.ai/server/@KISOpenAPI/kis-code-assistant-mcp
+- **스마트 검색**: 자연어로 원하는 API 기능 검색
+- **샘플코드 제공**: GitHub에서 실제 구현 코드 자동 검색
+- **카테고리별 탐색**: 기능별 체계적인 API 분류
+
+### KIS Trading MCP
+- **시세 조회**: 국내/해외 주식, 선물/옵션, 채권, ETF/ELW
+- **계좌 관리**: 잔고조회, 주문/체결내역, 손익현황
+- **매매 주문**: 현물/신용/선물옵션 주문 및 정정취소
+- **시장 분석**: 순위정보, 투자자별 매매동향, 프로그램매매
+
+## 💡 활용 예시
+
+### Claude와 함께 사용
+
+```
+사용자: "삼성전자 현재가와 호가창 정보 알려줘"
+Claude: [KIS OpenAPI] → 실시간 데이터 제공
+
+사용자: "내 계좌 잔고에서 수익률 높은 종목 5개 보여줘"
+Claude: [잔고 조회 + 데이터 분석] → 맞춤형 포트폴리오 분석
+```
+
+### Cursor IDE에서 활용
+
+```python
+# AI가 자동으로 API 호출 코드 생성 및 실행
+def get_stock_info(code):
+    """삼성전자 주가 정보를 가져오는 함수를 만들어줘"""
+    # MCP를 통해 실제 API 호출 코드가 자동 생성됨
+```
+
+## 🌟 특징
+
+- **데이터**: 지연 없는 시세 정보
+- **완전한 API 커버리지**: 한투 OpenAPI의 모든 기능 지원
+- **자연어 인터페이스**: 복잡한 API 문서 없이 대화로 사용
+- **코드 자동 생성**: 샘플코드를 기반으로 한 맞춤형 구현
+- **보안**: OAuth 토큰 기반 안전한 인증
+
+## 🎯 사용 시나리오
+
+### 개인 투자자
+
+- "오늘 상승률 상위 10개 종목의 PER, PBR 비교해줘"
+- "내 포트폴리오에서 손절매가 필요한 종목 찾아줘"
+
+### 퀀트 개발자
+
+- "볼린저밴드 돌파 전략으로 백테스팅 코드 만들어줘"
+- "RSI와 MACD 조합 신호로 매매 로직 구현해줘"
+
+### 핀테크 개발사
+
+- "고객별 맞춤 포트폴리오 추천 시스템 개발"
+- "실시간 리스크 모니터링 대시보드 구축"
+
+## 📈 왜 MCP인가?
+
+기존 REST API의 한계를 뛰어넘어, AI가 상황에 맞는 최적의 API를 선택하고 호출합니다. 개발자는 복잡한 API 문서를 읽을 필요 없이 자연어로 원하는 기능을 요청하면 됩니다.
+
+---
+
+*개발 지식이 있는 투자자라면 이제 아이디어만 있으면 됩니다. 복잡한 구현은 AI가, 실제 매매는 한투 API가 담당합니다. 더 스마트한 투자를 위한 새로운 도구를 경험해 보세요.*
+
+---