# 한국투자증권 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가 담당합니다. 더 스마트한 투자를 위한 새로운 도구를 경험해 보세요.*

---
