Zerodha Kite MCP 서버

Claude를 Zerodha 계정에 연결하여 과거 캔들, 주간/월간 존 레벨(PWH/PWL/PMH/PML + CPR 피벗), EMA 크로스오버 감지, 옵션 체인 데이터를 제공합니다.

1. Kite Connect 앱 자격 증명 얻기

1. https://developers.kite.trade/apps로 이동하여 새 앱을 만듭니다(이미 유료 ₹500/월 플랜을 사용 중이므로 이미 활성화되어 있어야 합니다).

2. 리다이렉트 URL을 https://<your-render-app-name>.onrender.com/callback으로 설정합니다(3단계에서 정확한 .onrender.com URL을 받게 됩니다 — 배포 후 다시 돌아와서 업데이트하세요).

3. API 키와 API 시크릿을 기록해 두세요.

Related MCP server: Fyers MCP Server

2. Render에 배포(무료 티어)

1. https://render.com에서 무료 계정을 만듭니다.

2. 이 폴더를 새 GitHub 저장소에 푸시합니다(또는 가능한 경우 Render의 "로컬 파일에서 배포" 옵션 사용).

3. Render에서: New > Web Service, 저장소를 연결합니다.

4. 빌드 명령어: pip install -r requirements.txt

5. 시작 명령어: python server.py

6. 환경 변수 추가(Render 대시보드 > Environment):

   • KITE_API_KEY

   • KITE_API_SECRET

   • (KITE_ACCESS_TOKEN은 설정하지 않음 — 로그인을 통해 매일 설정되며 저장되지 않음)

7. 배포합니다. Render는 https://kite-mcp-yourname.onrender.com과 같은 URL을 제공합니다.

8. Kite Connect 앱 설정으로 돌아가 리다이렉트 URL을 https://kite-mcp-yourname.onrender.com/callback으로 설정합니다.

무료 티어 참고: Render의 무료 웹 서비스는 약 15분간 트래픽이 없으면 절전 모드로 전환되며, 다음 요청 시 깨어나는 데 약 30-60초가 걸립니다. 이 사용 사례에는 적합합니다 — 수동으로 셋업을 확인하는 것이지 고빈도 거래를 실행하는 것이 아니므로.

3. 일일 로그인(필수 — Kite 토큰은 매일 만료됩니다)

각 거래일마다 Claude에게 셋업 확인을 요청하기 전에:

1. 브라우저에서 https://kite-mcp-yourname.onrender.com/login을 엽니다.

2. Zerodha 자격 증명 + 2FA로 로그인합니다(Kite 앱과 동일).

3. "Login successful"이 표시됩니다 — 그게 전부입니다. 하루 치는 완료된 것입니다.

이는 Zerodha/SEBI 보안 요구사항으로, 이 서버가 우회할 수 없습니다 — 토큰 수명을 하루 이상으로 연장할 방법은 없습니다.

4. Claude에 연결하기

1. Claude에서 Settings > Connectors > Add custom connector로 이동합니다.

2. 이름: Zerodha Trading Tools

3. URL: https://kite-mcp-yourname.onrender.com/mcp

4. 여기서는 OAuth가 필요 없습니다(인증은 위의 일일 로그인 단계에서 이루어지며, 실행 중인 서버 내부에 토큰을 설정합니다) — 저장합니다.

5. 채팅에서 커넥터를 활성화합니다.

Claude에 노출되는 도구

• get_historical_candles — OHLC 데이터(시간별/일별 등)

• get_zone_levels — PWH/PWL/PMH/PML + 주간 및 월간 CPR 피벗(S1/R1 등)

• detect_ema_crossovers — 시간별 캔들에서 5/20 EMA 강세/약세 크로스오버

• get_option_chain — 기초자산 + 만기일에 대한 행사가, LTP, OI, 매수/매도 호가

알려진 제한 사항

• 무료 Render 티어는 유휴 시 절전 모드로 전환됩니다 — 일정 시간 후 첫 요청은 느립니다.

• 액세스 토큰은 /login을 통해 매 거래일 갱신해야 합니다.

• get_option_chain은 IV/Greeks를 직접 반환하지 않습니다(Kite의 quote API는 이를 제공하지 않음) — Claude는 체인 데이터를 확보한 후 가격 움직임과 ATM 스트래들 프리미엄을 사용하여 IV 맥락을 추정할 수 있습니다. 나중에 더 정밀한 값이 필요하면 전용 IV 피드(예: Sensibull, NSE 옵션 체인)가 더 정확할 수 있습니다.